画像モデル
OneMuxの画像モデルAPIを通じて、画像の生成と編集を行います。
インターフェースの概要
画像モデルには専用のImagesインターフェースを使用してください。画像生成リクエストを/v1/chat/completionsに送信しないでください。
- 画像生成:
POST https://api.onemux.net/v1/images/generations - 画像編集:
POST https://api.onemux.net/v1/images/edits - 認証:
Authorization: Bearer YOUR_API_KEY - モデル: 現在のモデル一覧インターフェースが返す実際の画像モデルIDを使用してください
まず、現在利用可能なモデルを取得します:
curl https://api.onemux.net/v1/models \
-H "Authorization: Bearer $ONEMUX_API_KEY"
画像モデルが生成、編集、参照画像、サイズ、品質、出力形式などのパラメータをサポートするかどうかは、モデル一覧と実際の上流機能に従います。
画像生成
/v1/images/generationsを使用して、テキストから画像を生成するリクエストを送信します。
curl https://api.onemux.net/v1/images/generations \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
"size": "1024x1024",
"quality": "medium"
}'
主なパラメータ:
| パラメータ | 必須 | 説明 |
|---|---|---|
model | はい | 現在利用可能な画像モデルID |
prompt | はい | 画像の内容を説明するテキスト |
size | いいえ | 画像サイズ。対応範囲はモデルによって異なります |
quality | いいえ | 画像品質。対応する値はモデルによって異なります |
n | いいえ | 生成数。対応範囲はモデルによって異なります |
response_format | いいえ | b64_jsonまたはurl。対応モデルでのみ使用できます |
background | いいえ | 透明または不透明な背景。対応モデルでのみ使用できます |
output_format | いいえ | png、jpeg、webp。対応モデルでのみ使用できます |
あるモデルでサポートされているパラメータを、他の画像モデルでそのまま使用しないでください。model_not_found、invalid_model、またはパラメータ非対応のエラーが発生した場合は、モデルIDとモデルの機能を確認してください。
画像編集
/v1/images/editsを使用して既存の画像を編集します。一般的なOpenAI互換画像モデルでは、multipart/form-dataを使用して画像をアップロードします:
curl https://api.onemux.net/v1/images/edits \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-F "model=YOUR_IMAGE_MODEL_ID" \
-F "image[]=@input.png" \
-F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
-F "size=1024x1024"
複数の参照画像はimage[]を繰り返し指定して渡せます。例:
-F "image[]=@person.png" \
-F "image[]=@product.png"
画像の枚数、画像形式、マスク、参照画像URL、JSON編集形式は、モデルと上流チャネルによって異なります。これらのパラメータは、モデルが明示的にサポートしている場合にのみ使用してください。
Pythonでの呼び出し
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["ONEMUX_API_KEY"],
base_url="https://api.onemux.net/v1",
)
result = client.images.generate(
model="YOUR_IMAGE_MODEL_ID",
prompt="一张简洁的蓝色科技风产品海报",
size="1024x1024",
)
print(result.data[0].b64_json or result.data[0].url)
画像編集では通常、multipart形式でファイルを直接送信する必要があります。現在のPython SDKバージョンが対象モデルの編集パラメータをサポートしていない場合は、上記のcURLリクエストを使用してください。
レスポンス
成功時のレスポンスには通常、data配列が含まれます:
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}
一部のモデルでは、response_formatにurlを指定すると画像URLが返されます:
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
Base64が返された場合は、実際の画像形式に応じてファイルを保存してください。URLが返された場合は、一時URLの有効期限が切れる前にダウンロードして保存してください。
料金について
画像モデルの料金体系は一律のToken課金ではありません。OneMuxでは、モデルに現在設定されている料金ルールに基づいて精算します。料金体系には次のようなものがあります:
- 生成画像の枚数に応じた課金
- 画像の解像度または品質レベルに応じた課金
- 画像の入力・出力Token数、またはその他の上流使用量に応じた課金
実際の価格、課金単位、対応仕様は、モデルカタログに記載された各モデルの最新情報を確認してください。リクエストが失敗した場合、通常は成功結果に対応する画像料金は発生しませんが、具体的な動作はページの表示とサーバーの応答に従います。
よくある質問
会話インターフェースで画像を生成できないのはなぜですか?
画像モデルには専用のImagesルートを使用します。/v1/chat/completionsや、その他の対応していないインターフェースに送信すると、モデルがそのエンドポイントをサポートしていない、またはパラメータが不正であるというエラーが返されることがあります。
モデル名を取得できるのに、リクエストが失敗するのはなぜですか?
モデルが画像生成または画像編集を許可しているか、現在のAPI Keyに権限があるか、リクエストパラメータがそのモデルの対応範囲内か、対応する上流チャネルが利用可能かを確認してください。
画像リンクではなくBase64が返されるのはなぜですか?
モデルやresponse_formatの設定によって、レスポンス形式が決まります。b64_jsonを受け取った場合は、クライアント側でデコードして保存する必要があります。urlを受け取った場合は、返されたURLからダウンロードしてください。
画像生成に時間がかかる場合はどうすればよいですか?
高解像度、高品質、または複雑な編集リクエストは、処理に時間がかかる場合があります。クライアントには適切なリクエストタイムアウトを設定してください。クライアントがタイムアウトしたという理由だけで同じリクエストを再送信すると、タスクや料金が重複する可能性があります。
GPT Image 2.6:SVG、GIF、複雑度
GPT Image 2.6シリーズでは、SVG出力、GIFアニメーション出力、およびcomplexityパラメータが新たに追加されました。これらの機能は、対応するモデルと上流チャネルでのみ利用できます。
SVGを出力する
SVGは画像生成に使用し、画像編集には使用しません。生成インターフェースを呼び出す際、output_formatをsvgに設定し、nを1に設定します。レスポンス内の画像データはBase64です。デコード後、.svgファイルとして保存してください。
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一个简洁的蓝色几何图形标志",
"output_format": "svg",
"n": 1
}
一部の上流設定では、svg.modelなどの追加svgオブジェクトが必要になる場合もあります。モデルまたはチャネルの説明で明示的に必要とされている場合にのみ追加してください。すべての画像モデルとチャネルがSVGに対応しているわけではありません。
GIFアニメーションを出力する
この機能に対応するGPT Image 2.6モデルでは、画像生成インターフェースのoutput_formatをgifに設定できます。モデルが対応している場合は、frame_countとframe_duration_msでアニメーションのフレーム数と各フレームの表示時間を設定できます。GIFは生成機能です。画像編集インターフェースでもGIFが返されるとは限りません。
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一只蓝色小鸟循环拍打翅膀的动画",
"output_format": "gif",
"frame_count": 6,
"frame_duration_ms": 200
}
複雑度パラメータ
GPT Image 2.6シリーズはcomplexityに対応しています:low、medium、high。簡単な変更では低い複雑度を、文字が多い画像やレイアウトが複雑な画像では高い複雑度を試してください。これはqualityとは異なるパラメータです。複雑度を高くすると、生成に時間がかかる場合があります。
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一张细节丰富的城市街景编辑插画",
"complexity": "high",
"quality": "high"
}
上記のパラメータは、すべてのモデルに共通するものではありません。インターフェースでパラメータ非対応のエラーが返された場合は、任意パラメータを削除するか、選択したモデルとチャネルの対応状況を確認してください。