Netwrck > Tools > API Documentation > RA1 Art Generator

RA1 Art Generator API

The RA1 Art Generator API provides programmatic access to our advanced AI image generation system. Generate high-quality AI images based on text prompts using cutting-edge AI models.

Quick Start

Get started in 30 seconds. Here's a complete example to generate your first image:

Language:

import requests

response = requests.post(
    "https://netwrck.com/api/ra1-art-generator",
    json={
        "api_key": "YOUR_API_KEY",  # Get from https://netwrck.com/account
        "prompt": "A majestic mountain landscape at sunset",
        "size": "1024x1024"
    }
)

result = response.json()
print(f"Image URL: {result['image_url']}")

fetch('https://netwrck.com/api/ra1-art-generator', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',  // Get from https://netwrck.com/account
    prompt: 'A majestic mountain landscape at sunset',
    size: '1024x1024'
  })
})
.then(res => res.json())
.then(result => console.log('Image URL:', result.image_url));

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

Authentication

All API requests require your API key. Find it in your account settings.

Pricing

Each image costs 4 credits ($0.04 USD). Failed requests are not billed.

API Reference

POST /api/ra1-art-generator

Generate an AI image based on a text prompt.

Request Body

The request body must be a JSON object with the following 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	Image size in `widthxheight` format. Default: `"1024x1024"`. Supported sizes: `1024x1024` (Square) `1152x768` (Landscape 3:2) `768x1152` (Portrait 2:3) `1152x864` (Landscape 4:3) `864x1152` (Portrait 3:4) `1360x768` (Widescreen 16:9) `768x1360` (Tall 9:16)

Complete Code Examples

Here are full examples with error handling:

Language:

import requests
import json

api_url = "https://netwrck.com/api/ra1-art-generator"
api_key = "YOUR_ACTUAL_API_KEY" # Replace with your API key

payload = {
    "api_key": api_key,
    "prompt": "Enchanted forest with glowing mushrooms and a hidden path, fantasy art",
    "size": "1024x1024"
}

try:
    response = requests.post(api_url, json=payload, timeout=60)
    response.raise_for_status() # Raises an HTTPError for bad responses (4XX or 5XX)
    
    result = response.json()
    print("Image generated successfully:")
    print(f"Image URL: {result.get('image_url')}")
    print(f"Credits charged: {result.get('credits_charged')}")

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err}")
    print(f"Response content: {response.text}")
except requests.exceptions.RequestException as req_err:
    print(f"Request error occurred: {req_err}")
except json.JSONDecodeError:
    print(f"Failed to decode JSON response: {response.text}")

const apiUrl = 'https://netwrck.com/api/ra1-art-generator';
const apiKey = 'YOUR_ACTUAL_API_KEY'; // Replace with your API key

const payload = {
  api_key: apiKey,
  prompt: 'Cosmic whale swimming through a nebula, vibrant colors, digital painting',
  size: '1152x768'
};

async function generateArt() {
  try {
    const response = await fetch(apiUrl, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(payload),
    });

    const result = await response.json();

    if (!response.ok) {
      console.error('API Error:', result.error || `HTTP error! Status: ${response.status}`);
      return;
    }

    console.log('Image generated successfully:');
    console.log('Image URL:', result.image_url);
    console.log('Credits charged:', result.credits_charged);
  } catch (error) {
    console.error('Network or other error:', error);
  }
}

generateArt();

curl -X POST \
  https://netwrck.com/api/ra1-art-generator \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_ACTUAL_API_KEY",
    "prompt": "Steampunk owl with intricate mechanical details, close-up portrait",
    "size": "768x1152"
  }'

Response Examples

Success Response (200 OK)

Returns a JSON object with the details of the generated image.

{
  "image_url": "https://storage.googleapis.com/static.netwrck.com/static/generated_images/your_image.webp",
  "prompt_used": "A futuristic city with flying cars and neon lights, hyperrealistic, 8k",
  "size_used": "1360x768",
  "credits_charged": 4
}

Error Responses

401 Unauthorized: Invalid API key.

{ "error": "Invalid API key", "status": 401 }

402 Payment Required: Insufficient credits.

{ "error": "Insufficient credits", "status": 402 }

400 Bad Request: Missing or invalid parameters (e.g., prompt too long, invalid size).

{ "error": "Prompt is required and cannot be empty.", "status": 400 }

500 Internal Server Error: An unexpected error occurred on the server.

{ "error": "Internal server error", "status": 500 }

Netwrck > Tools > API Documentation > LTX Image to Video Generator

LTX Image to Video Generator API

Create short video clips from static images using AI animation. Perfect for adding motion to your still images or creating dynamic content.

Quick Start

Generate a video from an image in seconds:

Language:

import requests

response = requests.post(
    "https://netwrck.com/api/ltx-video-v097",
    json={
        "api_key": "YOUR_API_KEY",  # Get from https://netwrck.com/account
        "image_url": "https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp",
        "prompt": "aesthetic elf girl talking smiling kindhearted genuine"
    }
)

result = response.json()
print(f"Video URL: {result['video']['url']}")

fetch('https://netwrck.com/api/ltx-video-v097', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',  // Get from https://netwrck.com/account
    image_url: 'https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp',
    prompt: 'aesthetic elf girl talking smiling kindhearted genuine'
  })
})
.then(res => res.json())
.then(result => console.log('Video URL:', result.video.url));

curl -X POST https://netwrck.com/api/ltx-video-v097 \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "image_url": "https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp", 
    "prompt": "aesthetic elf girl talking smiling kindhearted genuine"
  }'

Authentication

All API requests require your API key. Find it in your account settings.

Pricing

Each video costs 5 credits ($0.05 USD). Failed requests are not billed.

API Reference

POST /api/ltx-video-v097

Generate an AI video from a static image using LTX video generation technology.

Request Body

The request body must be a JSON object with the following parameters:

Parameter	Type	Required	Description
api_key	string	Required	Your API key for authentication.
image_url	string	Required	A publicly accessible URL to the source image (e.g., PNG, JPG).
prompt	string	Optional	A text prompt to guide the video generation (e.g., "subtle looping motion", "eyes blinking"). If omitted, a default may be applied or the model might animate based on the image content. Max 500 characters.

Complete Code Examples

Here are full examples with error handling:

Language:

import requests
import json

api_url = "https://netwrck.com/api/ltx-video-v097"
api_key = "YOUR_ACTUAL_API_KEY" # Replace with your API key

payload = {
    "api_key": api_key,
    "image_url": "https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp",
    "prompt": "aesthetic elf girl talking smiling kindhearted genuine"
}

try:
    response = requests.post(api_url, json=payload, timeout=120) # Longer timeout for video
    response.raise_for_status()
    
    result = response.json()
    if result.get("video") and result["video"].get("url"):
        print("Video generated successfully:")
        print(f"Video URL: {result['video']['url']}")
    else:
        print("Video generation may have succeeded but no URL found in response:")
        print(json.dumps(result, indent=2))

except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err}")
    try:
        print(f"Response content: {response.json()}") # Try to print JSON error
    except json.JSONDecodeError:
        print(f"Response content: {response.text}") # Fallback to text
except requests.exceptions.RequestException as req_err:
    print(f"Request error occurred: {req_err}")
except json.JSONDecodeError:
    print(f"Failed to decode JSON response: {response.text}")

const apiUrl = 'https://netwrck.com/api/ltx-video-v097';
const apiKey = 'YOUR_ACTUAL_API_KEY'; // Replace with your API key

const payload = {
  api_key: apiKey,
  image_url: "https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp",
  prompt: "aesthetic elf girl talking smiling kindhearted genuine"
};

async function generateVideo() {
  try {
    const response = await fetch(apiUrl, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(payload),
    });

    const result = await response.json();

    if (!response.ok) {
      console.error('API Error:', result.error || `HTTP error! Status: ${response.status}`);
      return;
    }

    if (result.video && result.video.url) {
        console.log('Video generated successfully:');
        console.log('Video URL:', result.video.url);
    } else {
        console.warn('Video generation may have succeeded but no URL found in response:', result);
    }
  } catch (error) {
    console.error('Network or other error:', error);
  }
}

generateVideo();

curl -X POST \
  https://netwrck.com/api/ltx-video-v097 \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_ACTUAL_API_KEY",
    "image_url": "https://static.netwrck.com/static/uploads/aitrending-aesthetic-character-elf-photographic-good-looking-fantastic-1.webp",
    "prompt": "aesthetic elf girl talking smiling kindhearted genuine"
  }'

Netwrck > Tools > API Documentation > RA2V Text to Video Generator

RA2V Text to Video Generator API

Advanced AI text-to-video generation with intelligent routing. RA2V automatically selects the optimal backend based on your prompt complexity to deliver the best results for your video generation needs.

Quick Start

Generate advanced AI videos from text prompts with smart backend selection:

Language:

import requests

# Text-to-video generation with smart routing
response = requests.post(
    "https://netwrck.com/api/ra2v",
    json={
        "api_key": "YOUR_API_KEY",  # Get from https://netwrck.com/account
        "prompt": "A peaceful landscape with gentle camera movement"
    }
)

result = response.json()
print(f"Video URL: {result['video']['url']}")

// For complex video generation with smart routing
fetch('https://netwrck.com/api/ra2v', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',  // Get from https://netwrck.com/account
    prompt: 'A dynamic action sequence with multiple characters performing acrobatic stunts'
  })
})
.then(res => res.json())
.then(result => console.log('Video URL:', result.video.url));

curl -X POST https://netwrck.com/api/ra2v \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "prompt": "Cinematic scene with dramatic camera movements and special effects"
  }'

Authentication

All API requests require your API key. Find it in your account settings.

Pricing

Each video costs 100 credits ($1.00 USD). Failed requests are not billed.

Smart Backend Selection

RA2V automatically routes your request to the best backend based on your prompt complexity:

Simple animations: Used for prompts containing keywords like "idle", "zoom in", "calm", "gentle", "subtle", "looping", "still", "quiet", "peaceful", "slow", "breathing"
Complex video generation: Used for dynamic scenes, action sequences, and complex visual narratives with enhanced quality

API Reference

POST /api/ra2v

Generate AI video with intelligent backend routing based on prompt complexity.

Request Body

The request body must be a JSON object with the following parameters:

Parameter	Type	Required	Description
api_key	string	Required	Your API key for authentication.
prompt	string	Required	Text description of the video you want to generate. The system will automatically detect complexity and route accordingly. Max 1000 characters.

Response Examples

Success Response (200 OK)

Returns a JSON object with the details of the generated video.

{
  "video": {
    "url": "https://storage.googleapis.com/generated-videos/your_video.mp4"
  },
  "prompt_used": "A cinematic scene with dramatic lighting and camera movement",
  "credits_charged": 100,
  "remaining_credits": 450
}

Error Responses

401 Unauthorized: Invalid API key.

{ "error": "Invalid API key", "status": 401 }

402 Payment Required: Insufficient credits.

{ "error": "Insufficient credits. This video costs 100 credits.", "status": 402 }

400 Bad Request: Missing or invalid parameters.

{ "error": "Prompt is required and cannot be empty.", "status": 400 }

503 Service Unavailable: Video generation service failed.

{ "error": "Video generation service failed", "status": 503 }