Vývojáři · API v1

Jedno API.
Každý model.

Obrázky, video, zvuk a 3D za jedním API, placené ze stejného zůstatku jako studio. Klíč vytvoříte v Nastavení. CLI nainstalujete přes npm.

$ npm i -g femimg
Modely
699
Endpointy
9
Minimální dobití
3 €
01 · Příklady

Stejné volání, jakýkoli výstup

Změňte ID modelu a přepnete se mezi obrázkem, videem a řečí. Pole se řídí modelem.

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg
Ukázkový renderluma/uni-v1/text-to-image
02 · Rychlý start

První render ve třech krocích

  1. 01Vytvořte API klíčV Nastavení > Klíče API pojmenujte klíč a jednou ho zkopírujte. V sekci Platby dobijte od 3 €.export FEMIMG_API_KEY="YOUR_API_KEY"
  2. 02Spuštění renderuPošlete ID modelu a jeho vstupy. Okamžitě dostanete zpět generování se stavem queued.POST /api/v1/api/catalog/generations
  3. 03Dotazování a staženíDotazujte se na generování, dokud nemá stav succeeded, a pak stáhněte soubor.GET /api/v1/api/catalog/generations/ID/content
03 · CLI

Renderování z terminálu

Nástroj pro příkazový řádek pro skripty, CI a programátorské agenty, se stejnými klíči a stejným zůstatkem jako API. Nainstalujete ho přes npm, nebo můžete volat API přímo pomocí curlu.

$ npm i -g femimg
Skripty a CIRenderujte z libovolného shellu, úlohy nebo cronu.
Výstup JSONJeden dokument JSON na spuštění, připravený pro další krok.
Programátorští agentiVáš agent nejdřív ověří cenu a omezí, kolik utratí.
04 · Základy API

Připraveno pro produkci

Ověření

Token Bearer v hlavičce Authorization. Klíče vytvoříte v Nastavení.

Authorization: Bearer YOUR_API_KEY

Rendery na pozadí

Spuštění renderu odpoví okamžitě se stavem queued. Dotazujte se, dokud neskončí stavem succeeded, failed nebo refunded.

{ "status": "queued" }

Cena předem

Zjistěte přesnou cenu svých vstupů, aniž byste cokoli spouštěli. Každá částka je v eurocentech.

POST /api/v1/api/catalog/quote

Bezpečné opakování

Pošlete hlavičku Idempotency-Key a opakovaný požadavek nikdy neúčtuje dvakrát.

Idempotency-Key: render-042

Limity

Každý klíč má limit požadavků za minutu. Po jeho překročení přijde chyba 429.

429 Too Many Requests

Chyby a vrácení peněz

Chyby v JSON s kódem a zprávou. Nezdařený render se automaticky vrátí na váš zůstatek.

{ "status": "refunded" }
05 · Reference

Endpointy

Základní URL https://femimg.com/api/v1

GET/api/catalog/meNázev klíče, jeho limit a váš zůstatek
GET/api/catalog/modelsKatalog modelů s jejich cenami
GET/api/catalog/models/detail?id=MODEL_IDJeden model se všemi poli
POST/api/catalog/quotePřesná cena dané sady vstupů
POST/api/catalog/generationsSpuštění renderu libovolným modelem
GET/api/catalog/generationsVaše poslední generování
GET/api/catalog/generations/IDStav, cena a výsledek jednoho generování
GET/api/catalog/generations/ID/contentStažení hotového souboru
DELETE/api/catalog/generations/IDSmazání generování

Dobijte 3 € a začněte ještě dnes

API a studio sdílejí jeden zůstatek. Nezdařený render se vrací.