GPT Image

GPT Image モデルは統一された非同期ジョブ API で呼び出します。POST /api/generate でタスクを開始し、完了するまで GET /api/generate/{taskId} をポーリングします。このファミリーは 4 個のエンドポイントを提供します。

概要

すべてのエンドポイントは同じ外枠を共有し、変わるのは model と input フィールドだけです。モデルマーケットの playground から任意に実行できます。

認証

/api-keys で API キーを作成し、Bearer トークンとして送信します。ログイン中のブラウザからのリクエストはセッション cookie 経由でも動作します。

Authorization: Bearer <YOUR_API_KEY>

タスクの作成

POST

POST https://api.lithovas.com/api/generate

ボディ：{ "model": "<slug>", "input": { … } }

レスポンス：{ "taskId": "<id>", "state": "waiting" }

結果の照会

GET

GET https://api.lithovas.com/api/generate/<taskId>

レスポンス：{ "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

非同期

タスク作成の 200 は、タスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまでこのエンドポイントをポーリングしてください。失敗したタスクは課金されません。

エンドポイント

モデル	タスク	model slug
GPT Image 1.5	Text to Image	gpt-image/1-5-text-to-image
GPT Image 1.5	Image to Image	gpt-image/1-5-image-to-image
GPT Image 2	Text to Image	gpt/gpt-image-2-text-to-image
GPT Image 2	Image to Image	gpt/gpt-image-2-image-to-image

GPT Image 1.5 · Text to Image

POSTText to Imagegpt-image/1-5-text-to-image

input フィールド

promptstring必須

Text description of the image to generate

aspect_ratioenum<string>必須

Width-height ratio determining visual form

qualityenum<string>必須

Medium for balanced output; high for detailed

例

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image/1-5-text-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }
}'

GPT Image 1.5 · Image to Image

POSTImage to Imagegpt-image/1-5-image-to-image

input フィールド

input_urlsarray<string>必須

Input image file URLs (max 16 URLs)

promptstring必須

Text description of desired image generation or edit

aspect_ratioenum<string>必須

Width-height ratio of the image

qualityenum<string>必須

Quality: medium for balanced, high for detailed

例

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image/1-5-image-to-image",
  "input": {
    "input_urls": [
      "https://example.com/file"
    ],
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "3:2",
    "quality": "medium"
  }
}'

GPT Image 2 · Text to Image

POSTText to Imagegpt/gpt-image-2-text-to-image

input フィールド

promptstring必須

Text prompt for image generation (max 20000 chars)

aspect_ratioenum<string>任意

Image aspect ratio (some ratios unavailable for 2K/4K)

resolutionenum<string>任意

Output image resolution

例

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt/gpt-image-2-text-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "aspect_ratio": "auto",
    "resolution": "1K"
  }
}'

GPT Image 2 · Image to Image

POSTImage to Imagegpt/gpt-image-2-image-to-image

input フィールド

promptstring必須

Text prompt for image generation, up to 20000 characters

input_urlsarray<string>必須

Array of input image URLs (max 16 images)

aspect_ratioenum<string>任意

Output aspect ratio (5:4 and 4:5 limited to 1K)

resolutionenum<string>任意

Image resolution (1:1 cannot use 4K; auto limited to 1K)

例

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt/gpt-image-2-image-to-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "input_urls": [
      "https://example.com/file"
    ],
    "aspect_ratio": "auto",
    "resolution": "1K"
  }
}'