LA Leonardo APIDocumentation Admin Console

Public API

Build image and video generation into your product.

The public API exposes customer-safe jobs, usage, and results while keeping provider accounts, cookies, tokens, and rotation details private.

Base URLhttps://admin.seedance2unlimited.space
Transport
HTTPS + JSON
Authentication
Bearer API key
Workflow
Asynchronous jobs

Authentication

Customer API keys

Send the customer key in every `/v1` request. Keys use either live or test mode and are shown only once when created.

Request header
Authorization: Bearer ak_live_your_key
Keep keys server-side.Do not embed customer API keys in browser bundles or mobile applications.

Reliability

Idempotent generation

Every generate request requires a unique `Idempotency-Key`. Retrying the same payload returns the original job; reusing the key with a different payload returns HTTP 409.

Same key + same bodyExisting job returned
Same key + different body409 `idempotency_key_conflict`
POST/v1/images/generate

Generate an image

Creates a customer-owned GPT Image 2 job. Customer credits are reserved before provider work starts.

Request
{
  "prompt": "cinematic product photo",
  "quality": "LOW",
  "size": "16:9_SMALL"
}
202 response
{
  "ok": true,
  "jobId": "job_...",
  "status": "processing",
  "type": "image",
  "chargedCredits": 20
}
FieldTypeDescription
promptstringRequired generation instruction.
qualityenum`LOW` or `MEDIUM`.
sizeenum`16:9_SMALL`, `1:1_SMALL`, `2:3_SMALL`, or `9:16_SMALL`.
POST/v1/videos/generate

Generate a video

Creates a Seedance 2.0 Fast job with optional audio and image guidance.

Request
{
  "prompt": "drone shot over rice fields",
  "size": "16:9_SMALL",
  "duration": 15,
  "motionHasAudio": true
}
202 response
{
  "ok": true,
  "jobId": "job_...",
  "status": "processing",
  "type": "video",
  "chargedCredits": 9000
}

Image guidance

Reference images

Image and video requests accept one public HTTPS URL, data URL, or base64 source. The gateway selects a provider account with sufficient balance before uploading the reference.

Reference object
"referenceImage": {
  "imageUrl": "https://example.com/reference.png",
  "strength": "MID"
}
Upload safetyHTTPS only, maximum 20 MB, JPG/PNG/WEBP, with private-network URL protection.
GET/v1/jobs/:jobId

Synchronize and return job status.

GET/v1/jobs/:jobId/result

Return the completed image or video URL.

Poll job status and result

queuedprocessingcompletefailed
GET/v1/usage

Read customer usage

Returns the total customer balance, active reservations, and immediately available credits.

Response
{
  "creditsBalance": 12000,
  "creditsReserved": 9000,
  "creditsAvailable": 3000
}

Error contract

Consistent JSON errors

400Invalid requestValidation or missing idempotency key.
401Invalid API keyBearer key missing, revoked, or inactive.
402Balance lowCustomer has insufficient available credits.
409ConflictIdempotency key reused with another payload.
429LimitedRate, queue, or concurrency limit reached.
503UnavailableProvider capacity or job status temporarily unavailable.