開発者向け · API v1

ひとつの API。
すべてのモデル。

画像、動画、音声、3D をひとつの API で。支払いはスタジオと同じ残高です。キーは設定で作成でき、CLI は npm でインストールできます。

APIキーを取得クイックスタート

CLIをインストール

$ npm i -g ineveo

モデル: 699
エンドポイント: 9
最低チャージ額: €3

01 · 例

同じ呼び出しで、どんな出力も

モデル ID を変えるだけで、画像・動画・音声を切り替えられます。フィールドはモデルに合わせて変わります。

1# 1. Generate an image2curl -X POST https://ineveo.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $INEVEO_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://ineveo.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $INEVEO_API_KEY"17 18# 3. Download the file19curl https://ineveo.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $INEVEO_API_KEY" \21  -o result.jpeg

[02] クイックスタート

3 ステップで最初の生成

01API キーを作成メールでサインインし、設定の API キーを開いてキーを作成します。お支払いから €3 以上をチャージしてください。export INEVEO_API_KEY="YOUR_API_KEY"
02CLIをインストールコマンドはひとつ: npm i -g ineveo。キーは INEVEO_API_KEY から読み込まれます。npm i -g ineveo
03最初の生成を実行カタログからモデル ID を選び、プロンプトを送信します。--dry-run を付ければ、何も消費せずに価格を確認できます。ineveo run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/

[03] CLI

ターミナルから生成

シェル、CI ジョブ、コーディングエージェントから任意のモデルを実行。すべての生成は開始前に価格が決まり、同じ残高から支払われます。

スクリプトと CIモデルのすべてのフィールドがフラグになります。ローカルファイルは自動でアップロードされます。

stdout に JSON実行ごとに JSON ドキュメントをひとつ出力。進捗とエラーは stderr へ、失敗時は 0 以外の終了コード。

コーディングエージェントスキルファイルが、まず価格を確認して上限を設けるようエージェントに教えます。

CLI ガイド全文 →

コマンド機能

ineveo models --type videoすべての動画モデルと開始価格

ineveo run <model> -hモデルのフィールドをリアルタイムで取得: 型、デフォルト、許可される値

ineveo run <model> -p "<prompt>" -o ./out/生成して結果をフォルダーに保存

ineveo run <model> -p "..." --dry-run正確な価格を、何も消費せずに

ineveo run <model> -p "..." --max-price 0.50価格が上限を超えたら実行しない

ineveo run <model> -p "..." --json -o ./out/次のステップにそのまま使える JSON の結果

ineveo skill installコーディングエージェントに CLI の使い方を教える

[04] API の基本

本番運用のための設計

認証

Authorization ヘッダーに Bearer トークン。キーは設定で作成でき、いつでも取り消せます。

Authorization: Bearer YOUR_API_KEY

バックグラウンド生成

生成を開始すると、すぐに queued ステータスが返ります。成功、失敗、返金のいずれかになるまでポーリングしてください。

{ "status": "queued" }

まず価格を確認

何も開始せずに、入力内容の正確な価格を取得できます。金額はすべてユーロセント単位です。

POST /api/v1/api/catalog/quote

安全な再試行

Idempotency-Key ヘッダーを送れば、再試行したリクエストで二重に請求されることはありません。

Idempotency-Key: render-042

制限

キーごとに 1 分あたりの上限と、任意の 1 日の上限があります。上限を超えると API は 429 を返します。

429 Too Many Requests

エラーと返金

エラーはコードとメッセージ付きの JSON。失敗した生成は自動的に残高へ返金されます。

{ "status": "refunded" }

[05] リファレンス

エンドポイント

ベース URL https://ineveo.com/api/v1

API リファレンス全文 →

GET/api/catalog/meキーと残高

GET/api/catalog/modelsすべてのモデル

GET/api/catalog/models/detail?id=MODEL_ID1 つのモデルとそのフィールド

POST/api/catalog/quote指定した入力の価格

POST/api/catalog/generations生成を開始

GET/api/catalog/generations最近の生成

GET/api/catalog/generations/ID1 件の生成のステータス

GET/api/catalog/generations/ID/content結果ファイル

DELETE/api/catalog/generations/ID生成を削除

€3 をチャージして、今日リリース

設定でAPIキーを作成すれば、どのモデルも呼び出せます。CLI は npm で利用できます。失敗した生成は返金されます。

APIキーを取得料金を見る

ひとつの API。 すべてのモデル。