Netwrck

Netwrck > Tools > API Documentation > RA2 Art Generator

RA2 Image Editor API

Edit an existing image from a text prompt with one POST request. Upload a file or pass a base64 image, then copy code or agent instructions into your codebase.

POST /api/ra2-image-editor $0.04 per successful edit (4 credits) No charge on failed requests

Open Tool

API Tester

Production endpoint

API Key

Source Image

Prompt

Size

Seed

Status: idle

{}

Pricing & Credits

Cost Per Edit

$0.04 USD

4 credits per successful edit

Billing Policy

Success: Charged $0.04 (4 credits)

Failed: No charge

Only pay for successful edits

API Reference

POST /api/ra2-image-editor

Edit an image from a source image and a text description. Alias: /api/ra2-image-edit

Request Format

Send a POST request as multipart/form-data with these fields:

Field	Type	Required	Description
api_key	string	Required	Your API key for authentication. The `X-API-Key` header is also accepted.
image	file	Required	Source image upload. PNG, JPEG, or WebP. Max 10 MB.
prompt	string	Required	Text description of the edit to apply to the source image. Max 1000 characters.
size	string	Optional	Output 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 output size in `widthxheight` format. Both values must be multiples of 32, between 256 and 2048.
seed	integer	Optional	Fixes edit randomness for reproducible results. Omit for a random seed.

JSON Requests

Send Content-Type: application/json instead of a file upload, replacing image with one of these fields:

Field	Type	Required	Description
image_base64	string	Either	Base64 encoded source image. Data URL prefixes are stripped automatically.
image_url	string	Either	Public URL of the source image. Max 10 MB.

prompt, api_key, size or resolution, and seed work the same way as in the multipart form.

{
  "api_key": "YOUR_API_KEY",
  "prompt": "Turn the background into a sunset beach",
  "image_url": "https://example.com/source.png",
  "size": "square",
  "seed": 42
}

Response Examples

Success Response (200 OK)

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

{
  "success": true,
  "request_id": "ra2edit_1758500000_ab12cd34",
  "image_url": "https://netwrckstatic.netwrck.com/static/uploads/ai/tools/cutout-studio-sample.webp",
  "images": [
    "https://netwrckstatic.netwrck.com/static/uploads/ai/tools/cutout-studio-sample.webp"
  ],
  "prompt_used": "Turn the background into a sunset beach",
  "final_prompt": "Turn the background into a sunset beach",
  "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 fields, including the source image

502 Generation Error

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

Try again in a moment

Pro Tips for Better Edits

Prompt Writing

Describe the change, not the whole scene
Name the region: "replace the sky with a sunset"
Include style keywords like "watercolor", "oil painting"
Mention lighting: "golden hour", "studio lighting"

Source Images

PNG, JPEG, or WebP up to 10 MB
Pass public images with image_url instead of uploading
Keep the source at or above the target size for sharper output
Match size to the source aspect ratio when possible

Example Great Edits

"Turn the background into a sunset beach with palm trees, keep the subject unchanged"

"Convert this photo into a watercolor painting, soft edges, visible brush strokes"

"Replace the cloudy sky with a starry night, add a soft moon glow"

Language

                    import requests

with open("source.png", "rb") as image_file:
    response = requests.post(
        "https://netwrck.com/api/ra2-image-editor",
        data={
            "api_key": "YOUR_API_KEY",
            "prompt": "Turn the background into a sunset beach",
            "size": "square"
        },
        files={"image": ("source.png", image_file, "image/png")},
        timeout=180
    )

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

                    const form = new FormData();
form.append('api_key', 'YOUR_API_KEY');
form.append('prompt', 'Turn the background into a sunset beach');
form.append('size', 'square');
form.append('image', fileInput.files[0]);

const response = await fetch('https://netwrck.com/api/ra2-image-editor', {
  method: 'POST',
  body: form
});

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-image-editor \
  -F 'api_key=YOUR_API_KEY' \
  -F 'prompt=Turn the background into a sunset beach' \
  -F 'size=square' \
  -F '[email protected]'