Skip to Content

画像編集

POSThttps://ai-gateway.lolipop.jp/v1/images/edits

プロンプトの指示に従って、画像を編集します。

認証

Authorizationstring必須

Bearer <APIキー> の形式で指定します。 詳しくは認証を参照してください。

リクエストボディ

multipart/form-data で指定します。 モデルが対応していないパラメーターを指定すると、無視されるか 400 が返ります。 この一覧にないフィールドは、そのままプロバイダーに送信されます。

modelstring必須

使用するモデルのID。 モデルの一覧で、output_modality が image のモデルを指定します。

promptstring必須

編集する内容の説明。

imagefile必須

編集する画像。

maskfile

編集する範囲を示すマスク画像。

nintegerデフォルト値 1

生成する画像の枚数。

レスポンス

createdinteger

画像が作成された日時(UNIX時間、秒)。

dataarray

生成された画像の配列。

フィールドを表示フィールドを非表示
b64_jsonstring

Base64でエンコードした画像データ。 デコードすると、画像ファイルになります。

usageobject

トークンの使用量。

フィールドを表示フィールドを非表示
input_tokensinteger

入力のトークン数。

output_tokensinteger

出力のトークン数。

total_tokensinteger

入力と出力のトークン数の合計。

エラー

エラーの一覧はエラーを参照してください。

ステータスコードcode原因
400bad_requestリクエストボディの形式や値が正しくない
400invalid_requestプロバイダーがリクエストを拒否した
401invalid_api_keyAPIキーが正しくない
402insufficient_balanceクレジット残高が不足している
402budget_guardrail_exceeded予算の上限を超えている
403model_not_allowedモデルの利用が許可されていない
404model_not_foundモデルが見つからない、または画像を出力するモデルではない
429rate_limit_exceededレート制限を超えている
502upstream_errorプロバイダーから正常なレスポンスを受け取れなかった
503service_unavailableサービスが一時的に利用できない