Orchestrator API

Drop-in replacement for OpenAI Chat Completions. Pass a mode name as model.

curl https://api.aigatecloud.com/v1/chat/completions \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "quality",
    "messages": [{"role": "user", "content": "Write a cold-email hook for fintech CFOs"}]
  }'

import openai
client = openai.OpenAI(
    api_key="sk-aigate-...",
    base_url="https://api.aigatecloud.com/v1",
)
resp = client.chat.completions.create(
    model="quality",                 # or speed / cost / viral
    messages=[{"role": "user", "content": "Write a cold-email hook"}],
)
print(resp.choices[0].message.content)

const r = await fetch('https://api.aigatecloud.com/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${AIGATE_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'quality',
    messages: [{ role: 'user', content: 'Write a cold-email hook' }],
  }),
});
const data = await r.json();
console.log(data.choices[0].message.content);

Anthropic Messages API shape. Internally translates to chat.completions.

import anthropic
client = anthropic.Anthropic(
    api_key="sk-aigate-...",
    base_url="https://api.aigatecloud.com",
)
msg = client.messages.create(
    model="quality",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
)
print(msg.content[0].text)

Native one-call pipeline. Detects intent, runs caption + hashtags + (optional) image in parallel via the DAG planner.

Request body

Response (200)

{
  "id":              "post_a92bb3f0c8c14a9e",
  "mode":            "viral",
  "intent":          "ads",
  "caption":         "Discover serenity in every detail. Elevate...",
  "caption_model":   "llama-3.3-70b-versatile",
  "hashtags":        ["luxuryfengshui", "highendinterior", ...],
  "hashtags_model":  "llama-3.3-70b-versatile",
  "image_url":       "https://api.aigatecloud.com/img/{sha1}.jpg",
  "image_provider":  "pollinations.flux+cdn",
  "credits_used":    15
}

Example

curl https://api.aigatecloud.com/v1/generate-post \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idea": "selling luxury fengshui homes",
    "mode": "viral",
    "image": true
  }'

List available modes and their human-readable labels.

curl https://api.aigatecloud.com/v1/models -H "Authorization: Bearer $AIGATE_KEY"
{
  "data": [
    {"id": "speed",   "label": "⚡ Speed",   "use": "fast"},
    {"id": "cost",    "label": "💰 Save Cost", "use": "cheap"},
    {"id": "quality", "label": "⭐ Quality", "use": "best"},
    {"id": "viral",   "label": "🔥 Viral",   "use": "multi_step"}
  ]
}

Public CDN for cached image renders. Returned by /v1/generate-post when image:true. Cache-Control: public, max-age=2592000, immutable. No auth.

multipart/form-data, field name file. Accepts jpg/png/webp up to 8 MB. Returns a stable CDN URL on api.aigatecloud.com/img/ that you can pass as reference_url or image_url to other endpoints.

curl https://api.aigatecloud.com/v1/upload \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -F "[email protected]"

# → {"key":"upload-abc...", "url":"https://api.aigatecloud.com/img/upload-abc....jpg",
#    "bytes":40208, "content_type":"image/jpeg"}

Generate a new image from a prompt, or transform a previously uploaded one. Cached by sha1(mode + reference + prompt).

Request body

Cost: 10 credits per image. Cache hit returns instantly.

Recover an underexposed photo. Identity-preserving. Three intensity levels.

curl https://api.aigatecloud.com/v1/enhance/lowlight \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://api.aigatecloud.com/img/upload-abc.jpg",
    "mode": "balanced"
  }'

Apply long-exposure light streaks to a night scene. Works in two modes:

• Transform (with image_url): apply trails to your photo, motion blur on lights only.
• Generate (with prompt only): synthesize a night scene with light trails from scratch.

# Generate from prompt
curl https://api.aigatecloud.com/v1/effects/light-trails \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Tokyo Shibuya crosswalk at night",
    "intensity": "high"
  }'

# Transform a daytime photo
curl https://api.aigatecloud.com/v1/effects/light-trails \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://api.aigatecloud.com/img/upload-abc.jpg",
    "intensity": "medium",
    "convert_to_night": true
  }'

Combo effect: rainy night + light trails + neon reflections. Three sub-presets pick the right balance for the look you want. Subjects stay sharp; motion blur applied only to lights.

Preset cheat sheet

# Generate from prompt
curl https://api.aigatecloud.com/v1/effects/cinematic-rain \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Tokyo Shinjuku alley",
    "preset": "cinematic"
  }'

# Transform a photo (any time of day → cinematic rainy night)
curl https://api.aigatecloud.com/v1/effects/cinematic-rain \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://api.aigatecloud.com/img/upload-abc.jpg",
    "preset": "cyberpunk",
    "convert_to_night": true
  }'

Inpaint-style cleanup. Reconstructs background where unwanted elements were removed. Subject stays sharp. Works best on simple backgrounds; complex scenes get extra geometry/lighting guard prompts.

Cuts the subject and returns a PNG with full alpha channel. Self-hosted rembg / U2Net. Hair detail preserved. Output served at /img/{key}.png.

curl https://api.aigatecloud.com/v1/edit/remove-background \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://api.aigatecloud.com/img/upload-abc.jpg"}'

Transform a casual portrait into a polished studio shot. Identity-locked.

Style cheat sheet

Restore faces in old photos, low-res images, or AI-generated portraits. With Replicate BYOK: routes to tencentarc/gfpgan or sczhou/codeformer. Without BYOK: falls back to Pollinations img2img (lower quality but free).

Pro-grade upscaling. With Replicate BYOK: topazlabs/image-upscale. Without: Pollinations Flux upscale.

Text-driven precise image editing via black-forest-labs/flux-kontext-pro. Best-in-class prompt following for edits like "change the shirt to blue", "remove the chair", "make it sunset".

Replicate BYOK required. Returns 402 if no key in BYOK Vault.

curl https://api.aigatecloud.com/v1/edit/kontext \
  -H "Authorization: Bearer $AIGATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://api.aigatecloud.com/img/upload-abc.jpg",
    "prompt": "change the background to a sunset beach, keep the person identical"
  }'

Try the pipeline without an API key. 5 requests / hour / IP. No image generation.

curl https://api.aigatecloud.com/demo/generate-post \
  -H "Content-Type: application/json" \
  -d '{"idea":"sell luxury watches", "mode":"viral"}'

Run the same idea through all 4 modes in parallel. Used by the Lab Test page.

curl https://api.aigatecloud.com/demo/compare \
  -H "Content-Type: application/json" \
  -d '{"idea":"sell luxury watches"}'

Response shape:

{
  "idea":   "sell luxury watches",
  "intent": "ads",
  "modes": [
    {"mode": "speed",   "caption": "...", "hashtags": [...], "latency_ms": 1820, ...},
    {"mode": "cost",    ...},
    {"mode": "quality", ...},
    {"mode": "viral",   ...}
  ]
}