身份验证
在 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/从 shell、CI 任务或编程智能体运行任意模型。每次生成在开始前都会报价,并从同一个余额中扣除。
opencran login粘贴一次 API 密钥,验证后即保存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/quote发送 Idempotency-Key 请求头,重试的请求绝不会重复扣费。
Idempotency-Key: render-042每个密钥都有每分钟限额和可选的每日上限。超出限额时,API 返回 429。
429 Too Many RequestsJSON 格式的错误,包含错误码和消息。失败的生成会自动退还到你的余额。
{ "status": "refunded" }/api/catalog/me你的密钥和余额/api/catalog/models所有模型/api/catalog/models/detail?id=MODEL_ID单个模型及其字段/api/catalog/quote指定输入的价格/api/catalog/generations开始生成/api/catalog/generations你最近的生成/api/catalog/generations/ID单个生成的状态/api/catalog/generations/ID/content结果文件/api/catalog/generations/ID删除生成充值 €3,今天就上线
在设置中创建 API 密钥,即可调用任何模型。CLI 即将推出。失败的渲染会退款。