开发者 · API v1

一个 API。
所有模型。

图片、视频、音频和 3D 集于一个 API，与工作室共用同一余额。在设置中创建密钥。CLI 即将推出。

即将推出CLI 和 SDK 即将推出。下面的 REST API 现在即可使用。

模型: 672
接口: 9
最低充值: €3

01 · 示例

同一个调用，任意输出

更换模型 ID 即可在图片、视频和语音之间切换。参数随模型而定。

1# 1. Generate an image2curl -X POST https://femimg.com/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $FEMIMG_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://femimg.com/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $FEMIMG_API_KEY"17 18# 3. Download the file19curl https://femimg.com/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $FEMIMG_API_KEY" \21  -o result.jpeg

landing.dev.outputTitleluma/uni-v1/text-to-image

02 · 快速开始

三步完成首次渲染

01创建 API 密钥在设置 > API 密钥中为密钥命名并复制一次。在账单中充值，最低 €3。export FEMIMG_API_KEY="YOUR_API_KEY"
02发起渲染发送模型 ID 和输入参数，会立即返回状态为 queued 的生成任务。POST /api/v1/api/catalog/generations
03轮询并下载轮询生成任务，状态变为 succeeded 后下载文件。GET /api/v1/api/catalog/generations/ID/content

03 · CLI即将推出

在终端中渲染

面向脚本、CI 和编程智能体的命令行工具正在开发中，与 API 共用密钥和余额。在它发布之前，本页所有调用都可以用 curl 完成。

脚本与 CI可在任意 shell、任务或定时任务中渲染。

JSON 输出每次运行输出一个 JSON，可直接用于下一步。

编程智能体智能体会先查看价格，并限制花费。

04 · API 要点

为生产环境而建

身份验证

在 Authorization 请求头中使用 Bearer 令牌。密钥在设置中创建。

Authorization: Bearer YOUR_API_KEY

后台渲染

发起渲染会立即返回 queued 状态。持续轮询，直到变为 succeeded、failed 或 refunded。

{ "status": "queued" }

先报价

无需启动任务即可查询所给输入的准确价格。所有金额以欧分计。

POST /api/v1/api/catalog/quote

安全重试

发送 Idempotency-Key 请求头，重试请求不会重复扣费。

Idempotency-Key: render-042

限额

每个密钥都有每分钟请求上限，超出会返回 429 错误。

429 Too Many Requests

错误与退款

JSON 错误包含代码和消息。失败的渲染会自动退回余额。

{ "status": "refunded" }

05 · 参考

接口

基础 URL https://femimg.com/api/v1

GET/api/catalog/me密钥名称、限额和你的余额

GET/api/catalog/models模型目录及其价格

GET/api/catalog/models/detail?id=MODEL_ID单个模型及其全部字段

POST/api/catalog/quote一组输入的准确价格

POST/api/catalog/generations用任意模型发起渲染

GET/api/catalog/generations你最近的生成任务

GET/api/catalog/generations/ID单个生成任务的状态、费用和结果

GET/api/catalog/generations/ID/content下载生成好的文件

DELETE/api/catalog/generations/ID删除一个生成任务

充值 €3，今天就上线

API 与工作室共用一个余额。失败的渲染会退款。

获取 API 密钥查看价格

一个 API。所有模型。