認証
Authorization ヘッダーに Bearer トークン。キーは設定で作成でき、いつでも取り消せます。
Authorization: Bearer oc_live_...画像、動画、音声、3D をひとつの API で。支払いはスタジオと同じ残高です。キーは設定で作成できます。CLI は近日公開です。
近日公開Opencran CLI は準備中です。このページで使い方を先にご覧いただけます。それまではAPIをご利用ください。
npm i -g @opencran/cliモデル ID を変えるだけで、画像・動画・音声を切り替えられます。フィールドはモデルに合わせて変わります。
1import { writeFile } from "node:fs/promises";2 3const API = "https://opencran.com/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.OPENCRAN_API_KEY}` };5 6// 1. Generate an image7const res = await fetch(`${API}/generations`, {8 method: "POST",9 headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },10 body: JSON.stringify({11 modelId: "luma/uni-v1/text-to-image",12 inputs: { prompt: "Neon city street after rain, cinematic night", size: "16:9" },13 }),14});15let { generation } = await res.json();16 17// 2. Wait for the result18while (generation.status === "queued" || generation.status === "generating") {19 await new Promise((r) => setTimeout(r, 3000));20 ({ generation } = await (await fetch(`${API}/generations/${generation.id}`, { headers: auth })).json());21}22 23// 3. Save the file24const file = await fetch(`${API}/generations/${generation.id}/content`, { headers: auth });25await writeFile("result.jpeg", Buffer.from(await file.arrayBuffer()));
export OPENCRAN_API_KEY="oc_live_..."opencran run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/シェル、CI ジョブ、コーディングエージェントから任意のモデルを実行。すべての生成は開始前に価格が決まり、同じ残高から支払われます。
opencran loginAPI キーを一度貼り付けるだけ。検証して保存しますopencran whoamiキーの名前と残高opencran models --type videoすべての動画モデルと開始価格opencran run <model> -hモデルのフィールドをリアルタイムで取得: 型、デフォルト、許可される値opencran run <model> -p "<prompt>" -o ./out/生成して結果をフォルダーに保存opencran run <model> -p "..." --dry-run正確な価格を、何も消費せずにopencran run <model> -p "..." --max-price 0.50価格が上限を超えたら実行しないopencran run <model> -p "..." --json -o ./out/次のステップにそのまま使える JSON の結果opencran skill installコーディングエージェントに CLI の使い方を教えるAuthorization ヘッダーに Bearer トークン。キーは設定で作成でき、いつでも取り消せます。
Authorization: Bearer oc_live_...生成を開始すると、すぐに queued ステータスが返ります。成功、失敗、返金のいずれかになるまでポーリングしてください。
{ "status": "queued" }何も開始せずに、入力内容の正確な価格を取得できます。金額はすべてユーロセント単位です。
POST /api/v1/api/catalog/quoteIdempotency-Key ヘッダーを送れば、再試行したリクエストで二重に請求されることはありません。
Idempotency-Key: render-042キーごとに 1 分あたりの上限と、任意の 1 日の上限があります。上限を超えると API は 429 を返します。
429 Too Many Requestsエラーはコードとメッセージ付きの JSON。失敗した生成は自動的に残高へ返金されます。
{ "status": "refunded" }/api/catalog/meキーと残高/api/catalog/modelsすべてのモデル/api/catalog/models/detail?id=MODEL_ID1 つのモデルとそのフィールド/api/catalog/quote指定した入力の価格/api/catalog/generations生成を開始/api/catalog/generations最近の生成/api/catalog/generations/ID1 件の生成のステータス/api/catalog/generations/ID/content結果ファイル/api/catalog/generations/ID生成を削除€3 をチャージして、今日リリース
設定でAPIキーを作成すれば、どのモデルも呼び出せます。CLI は近日公開です。失敗した生成は返金されます。