画像を生成
ShareAI Images APIを使用して、サポートされるモデル、テキストプロンプト、および検証済みの画像生成オプションで画像を作成します。
このページについて
https://api.shareai.now/api/v1/images/generationsテキストプロンプトから画像を生成する。
- ベースURL
https://api.shareai.now- 認証
- Bearer APIキーまたは承認済みOAuthアクセストークン
現在ShareAIで有効化され、資格情報で許可された画像モデルを使用してください。モデルはサポートするサイズ、品質レベル、および出力オプションを決定します。
リクエストを送信#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/images/generations" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_IMAGE_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1,
"size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
リクエストフィールド#
| フィールド | 値 |
|---|---|
model | 有効化された画像生成モデルID。 |
prompt | 空でないテキスト説明。 |
n | モデルのサポートに応じて、1から10までの画像数。 |
size / quality | モデルがサポートするオプションのサイズと品質値。 |
response_format / output_format | モデルがサポートするオプションの応答およびファイル形式設定。 |
background | モデルがサポートするオプションの背景設定。 |
画像を読む#
返された data エントリを検査します。モデルと要求された形式に応じて、エントリにはHTTPS画像URLまたはbase64画像データが含まれます。実際に返された形式を使用してください。すべてのプロバイダーがURLを返すとは限りません。APIは返された画像URLを自動的にダウンロードしません。
サイズとタイミングの制限#
リクエストは同期的です。結合されたテキストは256 KiB、プロバイダー呼び出しは120秒、応答は2 MiBに制限されています。大きなbase64画像はその応答制限を超える可能性があります。適切な出力サイズまたはURL出力をサポートするモデルを選択してください。
慎重に再試行する#
画像生成には使用料が発生する場合があります。タイムアウトや曖昧なネットワーク障害の後は、再試行する前にアクティビティを確認してください。同じリクエストを繰り返すと、別の画像が生成され、課金される可能性があります。APIはプロバイダーへのリクエスト送信後に画像リクエストを自動的に再試行しません。
サポートされる操作#
このルートはテキストから画像を生成します。画像編集、バリエーション、マルチパートアップロード、およびストリーミング画像生成はサポートされていません。現在の課金には、互換性のあるモデル/プロバイダーのトークン使用契約が必要です。画像単位のみのプロバイダーは利用できない場合があります。
顧客認証を使用する#
承認済みのOAuthフローの場合、アクセストークンをBearerとして送信してください。アカウント資金による画像生成には surcharge と承認された使用プランが必要です。すべてのモデル、プロバイダー、およびアカウントの制限は引き続き適用されます。
最終更新日 2026年9月15日