ShareAI Platform Docs

画像を生成

同期JSONレスポンスにはデータ内の画像結果が含まれています。.

Markdownとして表示
このページについて
POST https://api.shareai.now/api/v1/images

画像を生成

ベースURL
https://api.shareai.now
認証
Bearer APIキーまたは承認済みOAuthアクセストークン
必須スコープ
inference or monetization_gateway

同期JSONレスポンスには画像結果が含まれています data. 別名 /api/v1/images/generations もサポートされています。サイズ、解像度、アスペクト比、品質、出力形式などのオプションは選択されたモデルに依存します。レスポンスは2 MiBに制限されており、必要に応じて画像数やサイズを減らしてください。返される画像は一辺8192ピクセルまでに制限されています。.

始める前に#

サーバーにSHAREAI_API_KEYを設定し、モデルプレースホルダーを現在有効なモデルに置き換えてください。APIキーをブラウザコードで公開しないでください。モデル、アカウント、資格情報、プロバイダーはすべてこの操作を許可する必要があります。以下のオプション設定はモデルのサポートが必要です。APIの安全範囲は、すべてのモデルがすべての値をサポートすることを保証するものではありません。.

リクエストを送信#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

リクエストフィールド#

フィールドタイプ意味と制限
model 必須文字列有効な公開モデル識別子を正確に指定してください。この操作を宣言し、資格情報で許可されている必要があります。.
prompt 必須文字列空でない生成プロンプト、最大256 KiBのUTF-8テキスト。.
n整数オプションの画像数、1~10;デフォルトは1。モデルによってはより少ない数が許可される場合があります。.
size文字列モデル対応の出力サイズ、最大100文字。例: 1024×1024。このオプションをサポートしていないモデルもあります。.
resolution文字列モデル対応の解像度セレクター、最大100文字;公開されている料金プランのバリアントと一致する必要があります。.
aspect_ratio文字列モデル対応のアスペクト比セレクター、最大100文字。.
quality文字列モデル対応の品質セレクター、最大100文字;異なるレートを選択する場合があります。.
response_format文字列モデル対応のレスポンス形式、最大100文字。操作によって結果がJSONかバイナリかが決まります。.
output_format文字列モデル対応の出力エンコーディングセレクター、最大100文字。.
background文字列モデルがサポートしている場合、オプションの画像背景設定。.
seed整数オプションのモデル対応シード。動画の場合は非負整数が必要で、再現性は実行者に依存します。.
input_references配列最大16個の型付きimage_url部分で、image_url.urlはHTTPS URLまたはサポートされている画像データURLに設定されます。モデルのサポートが必要です。.
providerオブジェクトオプションのプロバイダールーティング設定。プロバイダータグを受け入れる場合はprovider.onlyを使用してください。モデルIDのプレフィックスとして使用しないでください。アカウントと資格情報の制限は依然として適用されます。.

結果を読む#

成功時はHTTP 200でJSONを返します。同期JSONレスポンスには画像結果が含まれています。 data. 別名 /api/v1/images/generations もサポートされています。サイズ、解像度、アスペクト比、品質、出力形式などのオプションは選択されたモデルに依存します。レスポンスは2 MiBに制限されており、必要に応じて画像数やサイズを減らしてください。返される画像は一辺8192ピクセルまでに制限されています。.

請求単位#

画像料金は生成された画像、測定されたメガピクセル、入力参照、リクエスト、またはプロバイダーが報告したトークンを使用できます。画像URLは画像サイズの測定値ではありません。メガピクセル料金には返された画像の寸法が必要です。そのルートではbase64出力を使用してください。.

Consoleから正確な有効モデル識別子を選択してください。その宣言された操作と入出力機能がこのエンドポイントに一致する必要があります。テキストチャットモデルを別の操作に代用することはできません。資格情報、プロバイダー、アカウントの制限は依然として適用されます。.

料金と使用状況#

料金は選択されたモデル、プロバイダー、単位、バリアントに対してEUR AIクレジットで公開されます。そのアクティブな料金の次元のみが請求されます。見積もりは実行前にクレジットを予約します。最終的な請求は測定された使用量を使用します。料金は解像度、出力形式、または使用帯域によって異なる場合があります。最終的なShareAIのデビットはConsole Usageで確認してください。上流のコストフィールドやメディアバイトは、発明されたトークン数に変換されません。.

アクセスとエラー#

使用する inference 承認されたネットワークコスト推論または monetization_gateway 承認されたBuilderのマークアップおよび受け入れられた請求条件に基づきます。アイデンティティのみのアクセスでは支出は許可されません。検証、モデル認証、不足クレジット、レート制限、実行失敗は構造化された error. タイムアウトや送信の不確実性が発生した場合、別の有料リクエストを作成する前にUsageまたはビデオジョブを確認してください。.

最終更新日 2026年11月3日

ShareAIプラットフォームドキュメント
すべてのドキュメント

タイトルまたは内容で検索してください。

このページについて質問する

このページを探索するためのアシスタントを選択してください。または、ページをコピーして会話に貼り付けることもできます。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI