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で形式を識別できる場合があります。メタデータをpromptおよびmodelとともに保持します。

一部だけの結果を最終結果として公開しないでください。ストリーミング配信では、ドラフトイベントと完成した成果物を区別します。