开发者 · API v1

一个 API。
所有模型。

图像、视频、音频和 3D,全部通过一个 API。可从 Node、Python 或 curl 调用,也可用 Genlaxy CLI 在终端中编写脚本,费用都从与工作室相同的余额中扣除。

$npm i -g @genlaxy/cli
模型
641
接口
9
最低充值
€5
01 · 示例

同一个调用,任意输出

更换模型 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()));
生成示例luma/uni-v1/text-to-image
02 · 快速开始

三步完成首次生成

  1. 01创建 API 密钥用邮箱登录,打开设置中的 API 密钥并创建一个密钥。在账单中充值,最低 €5。export GENLAXY_API_KEY="gl_live_..."
  2. 02安装 CLI一条命令,需要 Node.js 18.3 或更高版本。也可以不装,直接用任意 HTTP 客户端调用 API。npm i -g @genlaxy/cli
  3. 03完成首次生成从目录中选择一个模型 ID 并发送提示词。加上 --dry-run 即可查看价格,不产生任何花费。genlaxy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
03 · CLI新

在终端中生成

从 shell、CI 任务或编程智能体运行任意模型。每次生成在开始前都会报价,并从同一个余额中扣除。

脚本与 CI模型的每个字段都是一个参数;本地文件会自动为你上传。
stdout 输出 JSON每次运行输出一个 JSON 文档,进度和错误写入 stderr,失败时返回非零退出码。
编程智能体一个技能文件教你的智能体先查价格,并设定上限。
完整 CLI 指南 →
命令作用
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
04 · API 要点

为生产环境打造

身份验证

在 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 Requests

错误与退款

JSON 格式的错误,包含错误码和消息。失败的生成会自动退还到你的余额。

{ "status": "refunded" }
05 · 参考

接口

基础 URL https://genlaxy.ai/api/v1/api/catalog

完整 API 参考 →
GET/me你的密钥和余额
GET/models所有模型
GET/models/detail?id=MODEL_ID单个模型及其字段
POST/quote指定输入的价格
POST/generations开始生成
GET/generations你最近的生成
GET/generations/ID单个生成的状态
GET/generations/ID/content结果文件
DELETE/generations/ID删除生成

充值 €5,今天就上线

API、CLI 和工作室共用一个余额。失败的生成会退款。