建立生成作業
請求包含 model、prompt,且只包含適用的成品參數:大小、長寬比、格式或結果數量。
請勿將文字模型當作圖像識別碼;應依模型目錄中的模態選擇模型。
圖像生成請求
bash
curl --request POST https://cicora.ai/api/v1/images \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "google/gemini-2.5-flash-image",
"prompt": "A precise editorial illustration of a delivery route at dusk",
"aspect_ratio": "1:1",
"resolution": "1K",
"n": 1
}'參考圖像與編輯
- 只以所選模型支援的形式,透過 input_references 傳送參考圖像。
- 圖像轉圖像與編輯使用相同的 /images 路由,並附上來源參照與文字指示。
- 傳送輸入檔案前,請檢查其 MIME 類型、大小與權利。
接收成品
在相容回覆中,將 data[].b64_json 讀取為圖像位元組;media_type 可用來識別格式。請將中繼資料與其提示及模型一併保留。
請勿將部分結果當成最終結果發布。使用串流傳遞時,請區分草稿事件與已完成的成品。