lashot API でつなぐ
新しい連携はこの経路です。キー 1 本、/v1 の形は 1 つ。特定ベンダーの SDK は不要です。
$LASHOT_BASE には実際に配置した API のアドレスを設定します。ローカル開発は http://localhost:8080、本番のアドレスは管理者に確認してください。この手順は公開本番サービスの稼働を保証するものではありません。
1. 準備
- コンソールの キー で API キーを作ります。秘密は一度だけ表示されます。この例には
models:read、generations:write、generations:read、assets:readと現在のプロジェクトへのアクセス権が必要です。 sandbox/imageでテスト結果を使って呼び出しを確認できます。現在の料金は モデルと価格 で確認してください。本番モデルのコードも同じページにあります(例:ark/seedream-4)。- ヘッダーは
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 を見る |
次
- すでに Ark / DashScope / Kling / MiniMax / 千帆のコードがある場合は 既存 SDK。
- メソッドとフィールドはコンソールの すべてのエンドポイント、または
GET $LASHOT_BASE/openapi.json。 - スクリプトなしなら Playground。