メインコンテンツへスキップ
POST
/
v1
/
images
/
generations
curl -X POST "https://api.lemondata.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A white cat sitting on a windowsill watching rain",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

​
リクエストボディ

​
model
string
デフォルト:"dall-e-3"
使用するモデル（例：dall-e-3、flux-pro、midjourney）。
​
prompt
string
必須
生成したい画像のテキスト説明。
​
n
integer
デフォルト:"1"
生成する画像の数（1-4、モデルにより異なる）。
​
size
string
デフォルト:"1024x1024"
画像サイズ。モデルによりオプションが異なります：
  • DALL-E 3: 1024x1024、1792x1024、1024x1792
  • その他のモデル: 512x512、1024x1024 など
​
quality
string
デフォルト:"standard"
画像品質（standard または hd）。DALL-E 3 のみ。
​
response_format
string
デフォルト:"url"
レスポンス形式：url または b64_json。
​
style
string
デフォルト:"vivid"
DALL-E 3 のスタイル：vivid または natural。
​
user
string
エンドユーザーの一意識別子。

​
レスポンス

​
同期レスポンス（DALL-E、Flux Schnell など）

​
created
integer
作成時の Unix タイムスタンプ。
​
data
array
生成された画像の配列。各オブジェクトには以下が含まれます：
  • url (string): 生成された画像の URL
  • b64_json (string): Base64 エンコードされた画像（リクエスト時に指定した場合）
  • revised_prompt (string): 使用されたプロンプト（DALL-E 3）

​
非同期レスポンス（Midjourney、Flux Pro、Ideogram など）

一部のモデルは処理に時間がかかるため、非同期レスポンスを返します：
​
created
integer
作成時の Unix タイムスタンプ。
​
task_id
string
ポーリング用の一意のタスク識別子。
​
status
string
初期ステータス：pending。
​
poll_url
string
結果をポーリングするための相対 URL（例：/v1/images/generations/{task_id}）。
​
data
array
プレースホルダーデータを含む配列。url は完了するまで空です。
status: "pending" を受け取った場合は、画像ステータスを取得 エンドポイントを使用して結果をポーリングしてください。
curl -X POST "https://api.lemondata.cc/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "A white cat sitting on a windowsill watching rain",
    "size": "1024x1024",
    "quality": "standard",
    "n": 1
  }'

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A fluffy white cat with bright eyes sitting peacefully on a wooden windowsill, watching raindrops stream down the glass window..."
    }
  ]
}

​
利用可能なモデル

モデルタイプ特徴
dall-e-3同期最高品質、プロンプト強化
dall-e-2同期高速、より手頃な価格
flux-pro非同期フォトリアリスティック、高品質
flux-schnell同期非常に高速
midjourney非同期アーティスティックなスタイル
ideogram-v3非同期最高のテキストレンダリング
stable-diffusion-3同期オープンソース、カスタマイズ可能
非同期モデルは status: "pending" を返し、ポーリングが必要です。結果の取得方法については画像ステータスを取得を参照してください。

​
非同期レスポンスの処理

非同期モデルの場合、レスポンスに status: "pending" が含まれているか確認してください： 
import requests
import time

def generate_image(prompt, model="midjourney"):
    # 画像生成リクエストを作成
    response = requests.post(
        "https://api.lemondata.cc/v1/images/generations",
        headers={"Authorization": "Bearer sk-your-api-key"},
        json={"model": model, "prompt": prompt}
    )
    data = response.json()

    # 非同期かどうかを確認
    if data.get("status") == "pending":
        task_id = data["task_id"]
        print(f"Async task started: {task_id}")

        # 結果をポーリング
        while True:
            status_resp = requests.get(
                f"https://api.lemondata.cc/v1/images/generations/{task_id}",
                headers={"Authorization": "Bearer sk-your-api-key"}
            )
            status_data = status_resp.json()

            if status_data["status"] == "completed":
                return status_data["data"][0]["url"]
            elif status_data["status"] == "failed":
                raise Exception(status_data.get("error", "Generation failed"))

            time.sleep(3)
    else:
        # 同期レスポンス
        return data["data"][0]["url"]

# 使用例
url = generate_image("a beautiful sunset over mountains", model="midjourney")
print(f"Generated image: {url}")

ボディ

application/json
​
prompt
string
必須

生成したい画像のテキスト説明。

​
model
string

使用するモデル（例： dall-e-3 、 flux-pro 、 midjourney ）。

​
n
integer

生成する画像の数（1-4、モデルにより異なる）。

​
size
string

画像サイズ。モデルによりオプションが異なります： DALL-E 3: 1024x1024 、 1792x1024 、 1024x1792 その他のモデル: 512x512 、 1024x1024 など

​
quality
string

画像品質（ standard または hd ）。DALL-E 3 のみ。

​
response_format
string

レスポンス形式： url または b64_json 。

​
style
string

DALL-E 3 のスタイル： vivid または natural 。

​
user
string

エンドユーザーの一意識別子。

レスポンス

200 - application/json

Response 200

​
created
integer

作成時の Unix タイムスタンプ。

​
data
object[]

プレースホルダーデータを含む配列。 url は完了するまで空です。

​
task_id
string

ポーリング用の一意のタスク識別子。

​
status
string

初期ステータス： pending 。

​
poll_url
string

結果をポーリングするための相対 URL（例： /v1/images/generations/{task_id} ）。