cURL Examples

Basic Image Generation

FLUX/dev - Simple Generation

curl -X POST https://firemoon.studio/api/v1/flux/dev \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over mountains"
  }'

FLUX/dev - Advanced Parameters

curl -X POST https://firemoon.studio/api/v1/flux/dev \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A futuristic city with flying cars, cyberpunk style, highly detailed",
    "num_images": 2,
    "image_size": "landscape_16_9",
    "guidance_scale": 7.5,
    "num_inference_steps": 35,
    "seed": 12345
  }'

Video Generation

Kling - Basic Video

curl -X POST https://firemoon.studio/api/v1/kling/kling-2-1-master \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A butterfly emerging from its chrysalis and flying away",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

Kling - Marketing Video

curl -X POST https://firemoon.studio/api/v1/kling/kling-2-1-master \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A sleek electric car driving through a futuristic city at sunset, smooth camera movement following the vehicle",
    "duration": "10",
    "aspect_ratio": "16:9",
    "seed": 42
  }'

Character Editing

Ideogram - Character Edit

curl -X POST https://firemoon.studio/api/v1/ideogram/v3-character-edit \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Change the character to wear a blue jacket and sunglasses",
    "image_url": "https://example.com/character.jpg",
    "style": "realistic",
    "magic_prompt_option": "auto"
  }'

API Information

Get API Version

curl https://firemoon.studio/api/v1

List Providers

curl https://firemoon.studio/api/v1/providers

List Models for Provider

# FLUX models
curl https://firemoon.studio/api/v1/providers/flux/models

# Ideogram models
curl https://firemoon.studio/api/v1/providers/ideogram/models

# Kling models
curl https://firemoon.studio/api/v1/providers/kling/models

Get Model Information

# FLUX/dev info
curl https://firemoon.studio/api/v1/flux/dev

# Kling video info
curl https://firemoon.studio/api/v1/kling/kling-2-1-master

Testing Scripts

Batch Image Generation

#!/bin/bash

# Set your API key
API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"

# Array of prompts
prompts=(
    "A serene mountain landscape at sunset"
    "A futuristic city skyline with neon lights"
    "A peaceful lake surrounded by autumn trees"
    "A rocket launching into space"
    "A butterfly resting on a flower petal"
)

echo "Generating images..."

for i in "${!prompts[@]}"; do
    prompt="${prompts[$i]}"
    echo "Generating image $((i+1))/${#prompts[@]}: $prompt"

    curl -X POST "$BASE_URL/flux/dev" \
      -H "Authorization: Bearer $API_KEY" \
      -H "Content-Type: application/json" \
      -d "{\"prompt\": \"$prompt\", \"num_images\": 1}" \
      --silent | jq '.images[0].url' 2>/dev/null || echo "Failed to generate"

    # Small delay to be respectful
    sleep 1
done

echo "Batch generation complete!"

Test All Providers

#!/bin/bash

API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"

echo "Testing FLUX image generation..."
curl -X POST "$BASE_URL/flux/dev" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A test image", "num_images": 1}' \
  -w "\nStatus: %{http_code}\nTime: %{time_total}s\n"

echo -e "\nTesting Kling video generation..."
curl -X POST "$BASE_URL/kling/kling-2-1-master" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A test video", "duration": "5"}' \
  -w "\nStatus: %{http_code}\nTime: %{time_total}s\n"

echo -e "\nTesting API info..."
curl "$BASE_URL" -w "\nStatus: %{http_code}\n"

echo -e "\nTesting providers list..."
curl "$BASE_URL/providers" -w "\nStatus: %{http_code}\n"

Rate Limit Testing

#!/bin/bash

API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"

echo "Testing rate limits..."

for i in {1..10}; do
    echo "Request $i:"
    curl -X POST "$BASE_URL/flux/dev" \
      -H "Authorization: Bearer $API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"prompt": "Rate limit test", "num_images": 1}' \
      --silent \
      -w "Status: %{http_code}, Remaining: %{header:X-RateLimit-Remaining}\n" \
      -o /dev/null

    sleep 0.5  # Small delay between requests
done

Error Testing

#!/bin/bash

API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"

echo "Testing error responses..."

# Invalid API key
echo "1. Invalid API key:"
curl -X POST "$BASE_URL/flux/dev" \
  -H "Authorization: Bearer invalid_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Test"}' \
  -w "\nStatus: %{http_code}\n"

# Missing prompt
echo -e "\n2. Missing prompt:"
curl -X POST "$BASE_URL/flux/dev" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  -w "\nStatus: %{http_code}\n"

# Invalid provider
echo -e "\n3. Invalid provider:"
curl -X POST "$BASE_URL/invalid-provider/model" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Test"}' \
  -w "\nStatus: %{http_code}\n"

# Invalid model
echo -e "\n4. Invalid model:"
curl -X POST "$BASE_URL/flux/invalid-model" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Test"}' \
  -w "\nStatus: %{http_code}\n"

Response Parsing

Extract Image URLs

# Generate image and extract URL
curl -X POST https://firemoon.studio/api/v1/flux/dev \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset"}' \
  | jq -r '.images[0].url'

Pretty Print Response

# Pretty print JSON response
curl -X POST https://firemoon.studio/api/v1/flux/dev \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A sunset"}' \
  | jq '.'

Automation Scripts

Generate and Download Images

#!/bin/bash

API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"
PROMPT="A beautiful landscape"
OUTPUT_DIR="./generated_images"

mkdir -p "$OUTPUT_DIR"

echo "Generating image..."
response=$(curl -s -X POST "$BASE_URL/flux/dev" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"prompt\": \"$PROMPT\", \"num_images\": 1}")

image_url=$(echo "$response" | jq -r '.images[0].url')

if [ "$image_url" != "null" ] && [ -n "$image_url" ]; then
    echo "Downloading image from: $image_url"
    filename="$OUTPUT_DIR/$(basename "$image_url")"
    curl -s "$image_url" -o "$filename"
    echo "Saved to: $filename"
else
    echo "Failed to generate image"
    echo "Response: $response"
fi

Monitor API Usage

#!/bin/bash

API_KEY="your_api_key_here"
BASE_URL="https://firemoon.studio/api/v1"
LOG_FILE="api_usage.log"

echo "$(date): Starting API usage monitoring" >> "$LOG_FILE"

while true; do
    # Make a test request to check rate limits
    response=$(curl -s -w "%{http_code}" -X POST "$BASE_URL/flux/dev" \
      -H "Authorization: Bearer $API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"prompt": "Usage monitoring", "num_images": 1}' \
      -D /tmp/headers.txt)

    status_code=$(tail -n1 /tmp/headers.txt | cut -d' ' -f2)
    remaining=$(grep -i "X-RateLimit-Remaining" /tmp/headers.txt | cut -d' ' -f2)

    echo "$(date): Status $status_code, Remaining $remaining" >> "$LOG_FILE"

    if [ "$remaining" -lt 10 ]; then
        echo "$(date): WARNING: Only $remaining requests remaining!" >> "$LOG_FILE"
    fi

    # Check every 30 seconds
    sleep 30
done

These cURL examples are perfect for testing the API, debugging issues, and integrating into scripts or automation workflows.

Core endpoints

Code examples

Basic Image Generation

FLUX/dev - Simple Generation

FLUX/dev - Advanced Parameters

Video Generation

Kling - Basic Video

Kling - Marketing Video

Character Editing

Ideogram - Character Edit

API Information

Get API Version

List Providers

List Models for Provider

Get Model Information

Testing Scripts

Batch Image Generation

Test All Providers

Rate Limit Testing

Error Testing

Response Parsing

Extract Image URLs

Pretty Print Response

Automation Scripts

Generate and Download Images

Monitor API Usage

​Basic Image Generation

​FLUX/dev - Simple Generation

​FLUX/dev - Advanced Parameters

​Video Generation

​Kling - Basic Video

​Kling - Marketing Video

​Character Editing

​Ideogram - Character Edit

​API Information

​Get API Version

​List Providers

​List Models for Provider

​Get Model Information

​Testing Scripts

​Batch Image Generation

​Test All Providers

​Rate Limit Testing

​Error Testing

​Response Parsing

​Extract Image URLs

​Pretty Print Response

​Automation Scripts

​Generate and Download Images

​Monitor API Usage

Basic Image Generation

FLUX/dev - Simple Generation

FLUX/dev - Advanced Parameters

Video Generation

Kling - Basic Video

Kling - Marketing Video

Character Editing

Ideogram - Character Edit

API Information

Get API Version

List Providers

List Models for Provider

Get Model Information

Testing Scripts

Batch Image Generation

Test All Providers

Rate Limit Testing

Error Testing

Response Parsing

Extract Image URLs

Pretty Print Response

Automation Scripts

Generate and Download Images

Monitor API Usage