AI 画像生成タスクを実行します。

リクエスト

AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、success または error の通知が来たら、受け取った task_id を使ってタスクの結果を照会します。設定と検証の詳細は Webhook 統合ガイドを参照してください。

Webhook がサポートされていない場合、または統合に使えない場合は、ポーリングを実装します。AI タスクを送信した後、一定の間隔（例：10 秒ごと）でステータスエンドポイントをポーリングし、success または error になるまで待ちます。

セキュリティ

BearerAuthenticationV2

ボディapplication/json必須

promptstring必須

画像を生成するためのプロンプト

例:"A little cat"

negative_promptstring

望ましくない内容のプロンプト

例:"dog"

template_idstring必須

テンプレートの ID。まず事前定義されたテンプレートを一覧表示し、テンプレートの ID を使用します。

例:"good_template_001"

stepsinteger

ステップ数は画像の品質と処理時間に影響します。
推奨ステップ数
10-15 ステップ: 迅速なプロンプトテストや大まかな調整に最適です。
15–20 ステップ: 多くのモデルが理想的な品質と時間のバランスを達成する範囲です。
20–30 ステップ: 顔、毛皮、建築要素など、非常に詳細な被写体を生成するのに最適です。

例:10

cfg_scalenumber

CFG (Classifier-Free Guidance) スケールは、AI モデルがテキストプロンプトにどの程度厳密に従うかを決定する数学的な設定です。
低い CFG (1 – 4): AI に高い創造的自由度があります。プロンプトを緩く解釈するため、抽象的または絵画的な結果になったり、テーマから逸脱した画像になる可能性があります。
中程度の CFG (5 – 10): 理想的なバランスです。ジェネレーターはテキストに厳密に従いながら、自然で高品質なビジュアルを維持します。
高い CFG (11+): AI はプロンプトのすべての単語に固執します。詳細はより鮮明で文字通りになりますが、スケールが高すぎると、色が過度に飽和したり、ノイズや不自然なアーティファクトが発生することがよくあります。

例:4

seedArray of integers

各画像は一意のシードで生成されます。同じシードを使用すると同じ画像を再現できます。シードは 1 つのみ受け付けます。

例:

[
  3843718472198472
]

width_ratiointeger

画像の比率の幅。

例:3

height_ratiointeger

画像の比率の高さ。

例:4

curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/text-to-image \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A little cat",
    "negative_prompt": "dog",
    "template_id": "good_template_001",
    "steps": 10,
    "cfg_scale": 4,
    "seed": [
      3843718472198472
    ],
    "width_ratio": 3,
    "height_ratio": 4
  }'

レスポンス

タスクの実行に成功しました

ボディapplication/json

statusinteger

レスポンスステータス

例:200

dataobject

レスポンス

{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}