获取 API Key
登录 NewAPI，在密钥页面创建 Key
IMAGE & VIDEO API · READY TO USE
一个 API Key
调用图片与视频模型
统一使用 agent.shyfai.com/v1。查看可用模型、复制请求示例，
或直接进入在线调试，不需要了解任何内部实现。
# 换成你的 API Key 即可调用
curl https://agent.shyfai.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"prompt": "极简产品摄影，柔和自然光",
"size": "1024x1024",
"response_format": "url"
}'
Authentication
Bearer API Key
Output
Image / Video URL
OpenAI-Compatible
·
文生图
·
图像编辑
·
文生视频
·
图生视频
·
在线调试
Quick start
从开通到第一次调用，只要三步
所有公开能力都从同一个地址接入。你只需要准备 Key、选择模型，然后发送请求。
选择公开模型
图片与视频统一使用 GET /v1/models 返回的模型 ID
调用或在线调试
复制示例，或在浏览器直接发送请求
What you can build
从一张图，到一套内容生产流程
面向真实业务场景选择能力，无需关心请求在服务端如何处理。
图片生成
用文字生成商品图、海报、社媒配图、概念图和视觉素材，支持常用比例与多档分辨率。
图片编辑
上传一张或多张参考图，用自然语言完成改图、风格迁移、构图调整和商品场景扩展。
视频生成
支持文生视频与图生视频，可选择时长、清晰度和横竖屏比例，适合短片、广告和动态展示。
业务自动化
将接口接入内容工作台、批量生产脚本或现有产品，让生成结果直接进入下一步业务流程。
Model catalog
公开模型与能力一目了然
模型不在官网前端写死。在线调试会调用 GET /v1/models，只展示当前账号实际可用列表。
IMAGE
在线测试图片模型 →
图片生成与编辑
动态获取
通用图片生成与编辑能力，以当前接口返回模型为准。
动态获取
高画质与精细视觉能力，以当前接口返回参数为准。
动态获取
参考图与多比例能力，以当前接口返回参数为准。
动态获取
高指令遵循的图片能力，以当前账号授权为准。
VIDEO
在线测试视频模型 →
视频生成
动态获取
文生视频与图生视频，时长和分辨率以接口返回能力为准。
动态获取
高画质视频能力，以当前账号授权为准。
动态获取
多时长、多分辨率视频能力，以当前接口返回为准。
动态获取
参考图视频能力，以当前接口返回为准。
动态获取
快速视频能力，以当前接口返回为准。
动态获取
多画面比例与参考图能力，以当前接口返回为准。
动态获取
视频生成能力，以当前接口返回为准。
Magic sub-site
1 分钟，开通自己的 AI 生图网站
不想自己开发前后端？直接开通 Magic 分站，配置品牌和运营信息， 就能把可用的生图网站交给用户。零开发成本，把时间留给获客和运营。
1 min
快速开通
无需开发不搭前端，不写生成接口
独立运营按自己的品牌和业务方式对外运营
模型即用图片生成能力开通即可使用
专注增长直接投入内容、渠道与用户增长
开通分站→设置品牌与运营信息→分享站点开始运营
API documentation
接口、参数、示例都在这里
图片请求同步返回 URL；视频创建后返回任务 ID，再查询任务状态与结果。
选择接口
点击后右侧示例同步切换- Header 使用
Authorization: Bearer <API_KEY> - 图片输出使用
response_format=url - 在线调试会按模型展示可用参数
curl https://agent.shyfai.com/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"prompt": "Minimal product shot, soft light",
"size": "1024x1024",
"response_format": "url"
}'import os
from openai import OpenAI
client = OpenAI(
base_url="https://agent.shyfai.com/v1",
api_key=os.environ["API_KEY"],
)
result = client.images.generate(
model="MODEL_ID",
prompt="Minimal product shot, soft light",
size="1024x1024",
response_format="url",
)
print(result.data[0].url)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://agent.shyfai.com/v1",
apiKey: process.env.API_KEY,
});
const result = await client.images.generate({
model: "MODEL_ID",
prompt: "Minimal product shot, soft light",
size: "1024x1024",
response_format: "url",
});
console.log(result.data[0].url);Choose your path
接入 API，或直接运营自己的生图网站
开发者可以立刻调接口；站长可以 1 分钟开通 Magic 分站。两条路径都已准备好。
Base URL https://agent.shyfai.com/v1
Auth Authorization: Bearer <API_KEY>