API documentation

All programmatic calls require an API key in the X-API-Key header. Create one on the API keys page.

X-API-Key: sk_alpha_REPLACE_ME_WITH_YOUR_KEY

curl -fsS -X POST 'https://api-staging.c3pool.cn/api/v1/customer/jobs/image-api' \
  -H 'X-API-Key: sk_alpha_REPLACE_ME_WITH_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "sd-1-5",
    "tasks": [
      {"prompt": "a serene mountain lake at dawn", "width": 512, "height": 512, "steps": 20}
    ]
  }'

const r = await fetch('https://api-staging.c3pool.cn/api/v1/customer/jobs/image-api', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sk_alpha_REPLACE_ME_WITH_YOUR_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'sd-1-5',
    tasks: [
      { prompt: 'a serene mountain lake at dawn', width: 512, height: 512, steps: 20 }
    ],
  }),
});
const body = await r.json();
console.log(body.data.job_id);

import os, requests
r = requests.post(
    "https://api-staging.c3pool.cn/api/v1/customer/jobs/image-api",
    headers={"X-API-Key": os.environ["GPU_AGENT_API_KEY"]},
    json={
        "model": "sd-1-5",
        "tasks": [
            {"prompt": "a serene mountain lake at dawn", "width": 512, "height": 512, "steps": 20}
        ],
    },
    timeout=15,
)
r.raise_for_status()
print(r.json()["data"]["job_id"])

• You can submit at most 10 jobs per minute (per customer).
• You can have at most 3 concurrent (running) jobs.
• A single job can request at most 4 images.

• Each completed task debits credits at the per-model rate.
• Failed / expired / validation-failed tasks do NOT debit credits.
• Duplicate completion events from outbox replay are de-duplicated by task id.