Netwrck

Netwrck > Tools > API Documentation > RA3 Art Generator

RA3 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/ra3-art-generator from $0.04 per successful image No charge on failed requests

Open Tool

API Tester

Production endpoint

API Key

Prompt

Size

Images

Seed

Status: idle

{}

Need to change an existing image instead? The RA3 Image Editor takes an image plus a prompt and keeps identity and composition (style transfer, object edits), same 4 credit price. RA3 is also the default image model on OpenPaths (model: "auto-image" or "ra3").

Pricing & Credits

Cost Per Image

from $0.04 USD

4 credits ($0.04) per fast image · 12 credits ($0.12) per image with quality: "hq"

Billing Policy

Success: Charged 4 credits ($0.04), or 12 ($0.12) in quality mode

Failed: No charge

Only pay for successful generations

API Reference

POST /api/ra3-art-generator

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

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.
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, multiples of 16 between 256 and 1536, up to about 1.2 megapixels (for example `1024x1024`, `1360x768`). Larger sizes return 400.
num_images	integer	Optional	Number of images to generate, `1` to `4`. Default: `1`. Credits scale with the image count.
quality	string	Optional	`"hq"` (also `"high"`, `"max"`, `"natural"`) selects the slower quality mode: a more natural, detailed look in roughly ten times the render time, charged at 3x (12 credits per image). Omit for the fast mode.
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": "ra3_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/ra3-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/ra3-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/ra3-art-generator \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "prompt": "A majestic mountain landscape at sunset, photorealistic",
    "size": "square"
  }'
                