Recent jobs
| Created | Model | Ratio | Status | Images |
|---|
Account pool and generation activity
| Created | Model | Ratio | Status | Images |
|---|
Send a bearer key from the API keys page.
Generated images appear here.
| Created | Source | Model | Prompt | Status | Account | Duration |
|---|
Base URL: . Authenticate every request with Authorization: Bearer sk-.... All examples below are ready to run.
Plain HTTP — works in terminals, n8n HTTP nodes, and scripts. No shell variables. The server assigns a unique job id automatically; parallel requests never collide.
| Field | Type | Default | Notes |
|---|---|---|---|
| Note: TikTok only generates 9:16 (864×1536) images by default — there is no aspect-ratio parameter. Image-to-image output follows the reference aspect ratio. | |||
model | string | nano-banana-pro | nano-banana-pro or seedream4.5. |
prompt | string | required | The image description. |
n | number | 1 | 1–4 images per request. |
response_format | string | url | url or b64_json. Aliases: base64, base_64, output_format, output. |
images | string[] | — | Up to 4 reference images: HTTPS URL or data URL. Presence switches to image-to-image. |
Prefer: respond-async | header | — | Returns 202 with x-job-id immediately; poll the job endpoint. |
Idempotency-Key | header | auto | Optional. Omit it — the server auto-generates a unique key (safe for n8n and parallel runs). Send your own value only when you want retries: same key → same job, no double charge. |
GET /v1/models — list available models.POST /v1/images/generations — text-to-image.POST /v1/images/edits — image-to-image (JSON references or multipart).GET /api/jobs/:id — job status with freshly signed media URLs.Returned url values point to this server, which proxies the provider CDN. They do not expose your cookies and stay valid for seven days, even when the upstream signed URL expires.
Images are never written to disk. Only job metadata and remote URLs are stored; retention cleanup runs every six hours.
Accounts, API keys, settings and job history live in DATA_DIR (Docker: /app/data). Mount a persistent volume at that path in Coolify so redeploys keep your data.