身份验证
在 Authorization 请求头中使用 Bearer 令牌。在设置中创建密钥,并可随时撤销任意密钥。
Authorization: Bearer gl_live_...图像、视频、音频和 3D,全部通过一个 API。可从 Node、Python 或 curl 调用,也可用 Genlaxy CLI 在终端中编写脚本,费用都从与工作室相同的余额中扣除。
npm i -g @genlaxy/cli更换模型 ID,即可在图像、视频和语音之间切换。字段随模型而定。
1import { writeFile } from "node:fs/promises";2 3const API = "https://genlaxy.ai/api/v1/api/catalog";4const auth = { Authorization: `Bearer ${process.env.GENLAXY_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 GENLAXY_API_KEY="gl_live_..."npm i -g @genlaxy/cligenlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/从 shell、CI 任务或编程智能体运行任意模型。每次生成在开始前都会报价,并从同一个余额中扣除。
genlaxy login粘贴一次 API 密钥,验证后即保存genlaxy whoami密钥名称和你的余额genlaxy models --type video所有视频模型及其起步价genlaxy run <model> -h实时获取模型字段:类型、默认值、允许的取值genlaxy run <model> -p "<prompt>" -o ./out/生成并将结果保存到文件夹genlaxy run <model> -p "..." --dry-run精确价格,不产生任何花费genlaxy run <model> -p "..." --max-price 0.50价格超出时拒绝运行genlaxy run <model> -p "..." --json -o ./out/一个 JSON 结果,可直接用于下一步genlaxy skill install教你的编程智能体使用 CLI在 Authorization 请求头中使用 Bearer 令牌。在设置中创建密钥,并可随时撤销任意密钥。
Authorization: Bearer gl_live_...发起生成后会立即返回 queued 状态。轮询该生成,直到成功、失败或已退款。
{ "status": "queued" }无需启动任何任务,即可获取你输入参数的精确价格。所有金额均以欧分计。
POST /api/v1/api/catalog/quote发送 Idempotency-Key 请求头,重试的请求绝不会重复扣费。
Idempotency-Key: render-042每个密钥都有每分钟限额和可选的每日上限。超出限额时,API 返回 429。
429 Too Many RequestsJSON 格式的错误,包含错误码和消息。失败的生成会自动退还到你的余额。
{ "status": "refunded" }/me你的密钥和余额/models所有模型/models/detail?id=MODEL_ID单个模型及其字段/quote指定输入的价格/generations开始生成/generations你最近的生成/generations/ID单个生成的状态/generations/ID/content结果文件/generations/ID删除生成充值 €5,今天就上线
API、CLI 和工作室共用一个余额。失败的生成会退款。