Netwrck

Netwrck > Tools > API Documentation > RA2 Art Generator

RA2 Art Generator API

Generate images from text prompts with one POST request. Use the tester to confirm your key, then copy code or agent instructions into your codebase.

POST /api/ra2-art-generator $0.04 per successful image No charge on failed requests

Open Tool

API Tester

Production endpoint

API Key

Prompt

Size

Images

Seed

Status: idle

{}

Pricing & Credits

Cost Per Image

$0.04 USD

4 credits ($0.04) per successful image

Billing Policy

Success: Charged $0.04 (4 credits)

Failed: No charge

Only pay for successful generations

API Reference

POST /api/ra2-art-generator

Generate high-quality AI images from text descriptions. Alias: /api/ra2

Request Format

Send a POST request with a JSON body containing these parameters:

Parameter	Type	Required	Description
api_key	string	Required	Your API key for authentication.
prompt	string	Required	Text description of the image you want to generate. Be detailed for best results. Max 1000 characters.
size	string	Optional	Size preset key. Default: `"square"`. Supported presets: `square` (1024x1024) `landscape` (1152x768) `portrait` (768x1152) `landscape43` (1152x864) `portrait43` (864x1152) `widescreen` (1360x768) `tall` (768x1360) Ignored when `resolution` is supplied.
resolution	string	Optional	Explicit size in `widthxheight` format. Both values must be multiples of 32, between 256 and 2048.
num_images	integer	Optional	Number of images to generate, `1` to `4`. Default: `1`. Credits scale with the image count.
seed	integer	Optional	Fixes generation randomness for reproducible results. Omit for a random seed.

Response Examples

Success Response (200 OK)

When your image is successfully generated, you'll receive:

{
  "success": true,
  "request_id": "ra2_1758500000_ab12cd34",
  "image_url": "https://netwrckstatic.netwrck.com/static/uploads/ai/blog/new-art-tools-hero.webp",
  "images": [
    "https://netwrckstatic.netwrck.com/static/uploads/ai/blog/new-art-tools-hero.webp"
  ],
  "prompt_used": "A futuristic city with flying cars and neon lights, hyperrealistic, 8k",
  "final_prompt": "A futuristic city with flying cars and neon lights, hyperrealistic, 8k",
  "credits_charged": 4,
  "price_cents": 4
}

Error Responses

If something goes wrong, you'll receive one of these error responses:

401 Unauthorized

{
  "error": "Authentication failed",
  "status": 401
}

Check your API key is correct

402 Payment Required

{
  "error": "Insufficient credits. Required: 4, Available: 0",
  "status": 402
}

Add more credits to your account

400 Bad Request

{
  "error": "Prompt is required",
  "status": 400
}

Check your request parameters

502 Generation Error

{
  "success": false,
  "error": "Image generation failed. Please try again."
}

Try again in a moment

Pro Tips for Better Results

Prompt Writing

Be specific and descriptive
Include style keywords like "photorealistic", "digital art"
Mention lighting: "golden hour", "studio lighting"
Add composition: "close-up", "wide angle", "aerial view"

Size Selection

1024x1024 - Social media posts
1360x768 - Website banners
768x1360 - Mobile wallpapers
1152x864 - Presentations

Example Great Prompts

"A cozy coffee shop interior, warm lighting, vintage furniture, steam rising from coffee cup, photorealistic, highly detailed"

"Futuristic cyberpunk city at night, neon signs, rain-soaked streets, flying cars, blade runner style, cinematic lighting"

"Portrait of a wise old wizard, long white beard, blue robes, magical staff, fantasy art style, detailed character design"

Language

                    import requests

response = requests.post(
    "https://netwrck.com/api/ra2-art-generator",
    json={
        "api_key": "YOUR_API_KEY",
        "prompt": "A majestic mountain landscape at sunset, photorealistic",
        "size": "square"
    },
    timeout=180
)

response.raise_for_status()
result = response.json()
image_url = result["image_url"]
print(image_url)
                

                    const response = await fetch('https://netwrck.com/api/ra2-art-generator', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    prompt: 'A majestic mountain landscape at sunset, photorealistic',
    size: 'square'
  })
});

if (!response.ok) {
  throw new Error(await response.text());
}

const result = await response.json();
console.log(result.image_url);
                

                    curl -X POST https://netwrck.com/api/ra2-art-generator \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "prompt": "A majestic mountain landscape at sunset, photorealistic",
    "size": "square"
  }'
                