lashot API でつなぐ

新しい連携はこの経路です。キー 1 本、/v1 の形は 1 つ。特定ベンダーの SDK は不要です。

$LASHOT_BASE には実際に配置した API のアドレスを設定します。ローカル開発は http://localhost:8080、本番のアドレスは管理者に確認してください。この手順は公開本番サービスの稼働を保証するものではありません。

1. 準備

  1. コンソールの キー で API キーを作ります。秘密は一度だけ表示されます。この例には models:read、generations:write、generations:read、assets:read と現在のプロジェクトへのアクセス権が必要です。
  2. sandbox/image でテスト結果を使って呼び出しを確認できます。現在の料金は モデルと価格 で確認してください。本番モデルのコードも同じページにあります(例:ark/seedream-4)。
  3. ヘッダーは x-api-key: $LASHOT_KEY、または Authorization: Bearer $LASHOT_KEY。

2. 使えるモデルを見る

curl -sS "$LASHOT_BASE/v1/models" \
  -H "x-api-key: $LASHOT_KEY"

3. 画像を 1 枚投げる

curl -sS -X POST "$LASHOT_BASE/v1/images/generations" \
  -H "x-api-key: $LASHOT_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "sandbox/image",
    "prompt": "a lighthouse at dusk, long exposure",
    "n": 1
  }'

202 とジョブ(object は job)が返ります。id を控えてください。

4. 結果を取る

curl -sS "$LASHOT_BASE/v1/jobs/$JOB_ID" \
  -H "x-api-key: $LASHOT_KEY"

status が succeeded になると、新規の非公開プロジェクトの outputs[].url は /v1/asset-versions/{id}/content 形式のルート相対パスになります。読み取りごとに現在のアクセス権とメディア審査を確認します。結果の asset_version_id を $VERSION_ID に設定し、同じ API から取得します。

curl --fail -sS "$LASHOT_BASE/v1/asset-versions/$VERSION_ID/content" \
  -H "x-api-key: $LASHOT_KEY" -o result.png

外部ストレージの URL にプラットフォームのキーを送信したり、認証情報付きでリダイレクトを追跡したりしないでください。TypeScript SDK の lashot.assets.download(versionId) は Response を返します。組織共有素材の従来の署名 URL には有効期限があります。審査待ち・却下されたバージョンは取得できません。GET /v1/jobs/$JOB_ID/events(SSE)を購読してから、再度ジョブを取得することもできます。

動画は POST /v1/videos/generations、モデルは sandbox/video かカタログの動画コードです。

約束

項目 内容
JSON キーは snake_case
金額 最小通貨単位(分)の文字列
時刻 UTC ISO 8601
書き込み Idempotency-Key を付ける。24 時間は同じキー・同じ本文で同じ結果
制限 429 のとき Retry-After を見る

次