API Imej & Video

Endpoint

Penjanaan imej dan video berkongsi satu endpoint. Hantar permintaan POST dengan prompt anda, dan gerbang menghala ke akaun hulu terbaik yang tersedia.

POST https://YOUR-BASE-URL/v1/images/generations

Penjanaan imej

Hasilkan imej dari penerangan teks. Permintaan mengikut format OpenAI images/generations. Model yang disokong termasuk Flux Pro, DALL·E 3, Stable Diffusion 3, dan banyak lagi — semua melalui endpoint yang sama.

Tetapkan model kepada mana-mana ID model imej dari plaza model. Respons mengandungi satu atau lebih URL imej yang dihasilkan.

curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro",
    "prompt": "A serene mountain lake at sunrise, photorealistic",
    "n": 1,
    "size": "1024x1024"
  }'

Suntingan imej

Sunting imej sedia ada dengan menyediakan topeng dan prompt baharu. Hantar permintaan multipart/form-data dengan medan imej, topeng, dan prompt.

Hanya model yang menyokong inpainting menerima suntingan. Semak plaza model untuk model yang serasi dengan suntingan.

curl https://YOUR-BASE-URL/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@./input.png" \
  -F "mask=@./mask.png" \
  -F "prompt=Replace the background with a futuristic cityscape" \
  -F "n=1" \
  -F "size=1024x1024"

Penjanaan video

Hasilkan video pendek dari prompt teks atau imej. Endpoint dan pengesahan yang sama berfungsi untuk model video. Masa respons lebih lama disebabkan kos pengiraan penjanaan video.

Sokongan video berkembang dengan pantas. Semak plaza model untuk model video terkini yang tersedia.

curl https://YOUR-BASE-URL/v1/images/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cinematic aerial view of a futuristic city at night",
    "n": 1,
    "size": "1920x1080"
  }'

Penggunaan & pengebilan

Permintaan imej dan video dibilkan setiap penjanaan pada kadar yang dipaparkan dalam plaza model. Dimensi imej (saiz), kualiti (hd/standard), dan bilangan imej yang diminta mempengaruhi kos token.

Penggunaan dikesan dalam papan pemuka bersama-sama penyelesaian teks, memberikan pandangan bersatu semua aktiviti gerbang.