SweetRouterAPI

Obrázky a videa

Obrázky

Text na obrázek nebo úprava existujícího obrázku z URL.

Generování obrázků má plnou kapacitu

Pro tento endpoint teď nepřijímáme nové uživatele. Ozvěte se nám, zapíšeme vás na čekací listinu a dáme vědět, jakmile se uvolní místo.

Napsat e-mailNapsat na Telegram
POST/v1/images

Tělo požadavku

Obrázky
PoleTypPopis
prompt
Povinné
stringCo vygenerovat nebo jak upravit zdroj. Až 4 000 znaků.
image_url
Volitelné
string (URL)Obrázek k úpravě přes http nebo https. Pro text na obrázek ho vynechte.
aspect_ratio
Volitelné
stringJeden z poměrů 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21. Výchozí 2:3.
resolution
Volitelné
string512 (asi 448×640), 1k (asi 832×1280, výchozí) nebo 2k (asi 1344×2048). Rozměry platí pro 2:3.
width / height
Volitelné
integerPřesný rozměr místo aspect_ratio a resolution. Pošlete oba, násobky 64 v rozsahu 256 až 2048, nejvýš 4,2 megapixelu.
num_outputs
Volitelné
integerKolik obrázků vygenerovat, 1 až 4. Výchozí 1.
output_format
Volitelné
stringwebp (výchozí, nejmenší), jpeg nebo png.
output_quality
Volitelné
integerKvalita pro webp a jpeg, 1 až 100. Výchozí 90.
webhook_url
Volitelné
string (URL)HTTPS adresa, kterou upozorníme po dokončení úlohy. Viz Webhooky.

Příklad

curl
curl -X POST https://api.sweetrouter.com/v1/images \
  -H "Authorization: Bearer $SWEETROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a red apple on a wooden table, soft window light",
    "aspect_ratio": "2:3",
    "resolution": "1k",
    "num_outputs": 2,
    "output_format": "webp"
  }'
response
{
  "id": "cmg8x2k0d0001",
  "object": "job",
  "type": "image",
  "status": "queued",
  "num_outputs": 2,
  "outputs": [
    { "index": 0, "status": "pending", "url": null },
    { "index": 1, "status": "pending", "url": null }
  ],
  "cost_usd": "0.10",
  "expires_at": null
}

Volání hned vrátí úlohu se stavem queued. Dotazujte se na GET /v1/jobs/:id nebo použijte webhook a pak stáhněte každé outputs[].url.

Účtování

Každý požadovaný obrázek se účtuje při vytvoření úlohy. Když některé výstupy selžou, automaticky je vrátíme. Viz Ceník.

Bezpečné opakování

Pošlete hlavičku Idempotency-Key. Opakovaný požadavek se stejným klíčem vrátí původní úlohu, místo aby vytvořil a naúčtoval novou.

curl
curl -X POST https://api.sweetrouter.com/v1/images \
  -H "Authorization: Bearer $SWEETROUTER_API_KEY" \
  -H "Idempotency-Key: order-8812-hero" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a lighthouse at dusk"}'