自动化 API

在代码、工作流和 agent 里调用 NoAIVibe

通过简单 API 创建 Clean AI Vibe 或 Make It Look Real 任务,适合批量内容、电商素材和 AI agent 自动化。

API quickstart

三步从上传到结果

01

1. Create an API key

登录后进入 Account,创建带权限范围的 key,并把 secret 放到你的服务端或 agent 运行环境。

02

2. Upload or pass an image URL

本地文件使用 POST /api/v1/uploads,已有公网图片则直接把 image_url 发给任务接口。

03

3. Poll and download

创建任务后轮询状态,完成后通过下载接口获取结果。

核心接口

图片自动化接口

POST /api/v1/uploads上传 JPG、PNG 或 WEBP,返回可用于任务的 image_url
POST /api/v1/images/jobs创建 Clean 或 Realistic 图片任务,并预留 credits。
POST /api/v1/images/generate先从文字生成图片,再在同一任务里运行 NoAIVibe 引擎。
POST /api/v1/text/polish润色短发布文案,每次 1 credit。
GET /api/v1/images/jobs/{job_id}查询 queued、processing、completed 或 failed 状态。
GET /api/v1/images/jobs/{job_id}/download跳转到已完成任务的结果图地址。
GET /api/v1/api-keys查看 key 状态和每个 key 的消耗,不暴露 secret。
DELETE /api/v1/api-keys/{key_id}立即删除 key,同时保留历史消耗数据。
Example request

创建图片处理任务

curl -X POST https://noaivibe.com/api/v1/images/jobs \
  -H "Authorization: Bearer noaivibe_live_..." \
  -H "Content-Type: application/json" \
  -d '{"mode":"clean","image_url":"https://example.com/image.webp","webhook_url":"https://example.com/noaivibe-callback"}'

使用 GET /api/v1/images/jobs/{job_id} 轮询状态;任务完成后调用 GET /api/v1/images/jobs/{job_id}/download 下载结果。

密钥管理

API key management

登录用户可以在 Account 里创建和删除带权限范围的 key。Key 支持 images:writeimages:readtext:write,secret 只展示一次;每个 key 都会记录 credits 消耗、图片任务、文字请求和最近使用时间。

curl -X POST https://noaivibe.com/api/v1/api-keys \
  -H "Cookie: noaivibe_session=..." \
  -H "Content-Type: application/json" \
  -d '{"name":"agent workflow","scopes":["images:write","images:read","text:write"]}'

Free

API key preview

Use the 5 one-time credits to test automation with a small number of jobs.

Limit: trial_only

Creator

Production API

Best fit for creators and sellers who run image polish from content workflows.

Limit: account_credits

Pro

Higher-volume API

Best fit for content teams, ecommerce catalogs, and scheduled publishing pipelines.

Limit: account_credits

Credit Packs

Usage top-up

Add credits for launches, batches, and agent-driven workflows.

Limit: purchased_credits