cicora.ai
API 規格圖像生成

圖像

透過單一路由建立圖像,並依所選模型的功能選擇參數。

整合參考:請從帳戶 API 設定及適用於您環境的模型目錄中選擇參數與可用功能。

建立生成作業

請求包含 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 可用來識別格式。請將中繼資料與其提示及模型一併保留。

請勿將部分結果當成最終結果發布。使用串流傳遞時,請區分草稿事件與已完成的成品。