API 文档
Base URL: https://bytesite.xiaojiaixhs.com
认证: 在请求头中添加 Authorization: Bearer YOUR_API_KEY
统一响应格式
成功响应:
{
"data": [...],
"message": "success"
}
失败响应:
{
"error": {
"code": 401,
"message": "Invalid API key"
}
}
GET /user.php
获取当前用户的使用情况
curl 示例:
curl -X GET https://bytesite.xiaojiaixhs.com/user.php \
-H "Authorization: Bearer YOUR_API_KEY"
响应示例:
{
"name": "用户名",
"daily_limit": 100,
"daily_used": 25,
"monthly_limit": 3000,
"monthly_used": 500,
"expires_at": "2026-12-31"
}
POST /v1/images/generations
生成图片
支持的模型:
| 模型ID |
模型名称 |
说明 |
jiguang-5.0 | 极光5.0 | 最新版本,推荐使用 |
jiguang-4.6 | 极光4.6 | 稳定版本 |
jiguang-4.5 | 极光4.5 | 经典版本 |
jiguang-4.0 | 极光4.0 | 基础版本 |
jiguang-3.5 | 极光3.5 | 轻量版本 |
jiguang-3.0 | 极光3.0 | 快速生成 |
jiguang-2.5 | 极光2.5 | 标准版本 |
jiguang-2.0 | 极光2.0 | 通用版本 |
jiguang-1.5 | 极光1.5 | 入门版本 |
jiguang-1.0 | 极光1.0 | 初代版本 |
jiguang-lite | 极光轻量版 | 快速预览 |
jiguang-pro | 极光专业版 | 高质量输出 |
请求参数:
{
"model": "jiguang-5.0",
"prompt": "图片描述",
"ratio": "1:1",
"resolution": "1k"
}
curl 示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jiguang-5.0",
"prompt": "一只可爱的猫咪坐在窗边",
"ratio": "1:1",
"resolution": "1k"
}'
POST /v1/videos/generations
生成视频
支持的模型:
| 模型ID |
模型名称 |
说明 |
jiguang-video-3.5-pro | 极光视频3.5 Pro | 最新专业版,推荐使用 |
jiguang-video-3.5 | 极光视频3.5 | 标准版本 |
jiguang-video-3.0 | 极光视频3.0 | 稳定版本 |
jiguang-video-2.5 | 极光视频2.5 | 通用版本 |
jiguang-video-2.0 | 极光视频2.0 | 经典版本 |
jiguang-video-seedance-2.0 | Seedance 2.0 | 舞蹈动作专用 |
jiguang-video-seedance-1.5 | Seedance 1.5 | 舞蹈动作 |
jiguang-video-lite | 极光视频轻量版 | 快速生成 |
jiguang-video-hd | 极光视频高清版 | 高清输出 |
jiguang-video-4k | 极光视频4K版 | 超高清输出 |
请求参数:
{
"model": "jiguang-video-3.5-pro",
"prompt": "视频描述",
"duration": 5,
"ratio": "16:9",
"resolution": "720p"
}
curl 示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jiguang-video-3.5-pro",
"prompt": "一只猫咪在草地上奔跑",
"duration": 5,
"ratio": "16:9",
"resolution": "720p"
}'
POST /v1/images/compositions
图片合成接口,支持多图融合、风格迁移等高级图像处理
请求参数示例:
{
"model": "jiguang-5.0",
"prompt": "将两张图片融合成一张",
"images": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"composition_mode": "blend",
"ratio": "16:9",
"resolution": "2k"
}
参数说明:
| 参数 |
类型 |
必填 |
说明 |
| model | string | 是 | 使用的模型ID |
| prompt | string | 是 | 合成描述 |
| images | array | 是 | 图片URL数组(2-4张) |
| composition_mode | string | 否 | 合成模式:blend(融合)、style(风格迁移)、merge(拼接),默认blend |
| ratio | string | 否 | 输出比例,默认1:1 |
| resolution | string | 否 | 输出分辨率,默认2k |
curl 示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/compositions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jiguang-5.0",
"prompt": "将两张图片融合成一张艺术作品",
"images": [
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"composition_mode": "blend",
"ratio": "16:9",
"resolution": "2k"
}'
分辨率支持
图片分辨率:
| 比例 |
1k |
2k |
4k |
| 1:1 | 1024×1024 | 2048×2048 | 4096×4096 |
| 16:9 | 1024×576 | 2048×1152 | 4096×2304 |
| 9:16 | 576×1024 | 1152×2048 | 2304×4096 |
| 4:3 | 1024×768 | 2048×1536 | 4096×3072 |
| 3:4 | 768×1024 | 1536×2048 | 3072×4096 |
视频分辨率:
| 分辨率 |
尺寸 |
说明 |
| 480p | 854×480 | 标清 |
| 720p | 1280×720 | 高清(推荐) |
| 1080p | 1920×1080 | 全高清 |
| 2k | 2560×1440 | 2K超清 |
| 4k | 3840×2160 | 4K超高清 |
参数详细说明
| 参数 |
类型 |
必填 |
说明 |
示例值 |
错误码说明
| 错误码 |
说明 |
解决方案 |
| 401 | API Key无效或未提供 | 检查Authorization头是否正确 |
| 403 | 权限不足或额度已用完 | 检查账户额度或升级套餐 |
| 404 | 请求的资源不存在 | 检查API端点路径是否正确 |
| 429 | 请求过于频繁 | 降低请求频率或稍后重试 |
| 500 | 服务器内部错误 | 稍后重试或联系技术支持 |
错误响应示例:
{
"error": {
"code": 403,
"message": "Daily quota exceeded"
}
}
| model | string | 是 | 模型ID | jiguang-5.0 |
| prompt | string | 是 | 生成描述(中英文均可) | 一只可爱的猫咪 |
| ratio | string | 否 | 图片比例,默认1:1 | 1:1, 16:9, 9:16, 4:3, 3:4 |
| resolution | string | 否 | 分辨率,默认1k | 1k, 2k, 4k, 720p, 1080p |
| duration | number | 否 | 视频时长(秒),默认5 | 5, 10, 15 |
| seed | number | 否 | 随机种子,固定生成结果 | 12345 |
| n | number | 否 | 生成数量,默认1 | 1, 2, 3, 4 |
POST /v1/images/edits
基于参考图生成新图片
请求参数:
{
"model": "jiguang-5.0",
"prompt": "将这只猫咪变成卡通风格",
"image": "https://example.com/cat.jpg",
"ratio": "1:1",
"resolution": "2k",
"strength": 0.7
}
参数说明:
| 参数 |
类型 |
必填 |
说明 |
| image | string | 是 | 参考图片URL或base64 |
| strength | number | 否 | 变化强度 0.1-1.0,默认0.7 |
curl示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/images/edits \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jiguang-5.0",
"prompt": "将这只猫咪变成卡通风格",
"image": "https://example.com/cat.jpg",
"ratio": "1:1",
"resolution": "2k",
"strength": 0.7
}'
POST /v1/videos/seedance
Seedance舞蹈视频生成(图片驱动人物跳舞)
请求参数:
{
"model": "jiguang-video-seedance-2.0",
"image": "https://example.com/person.jpg",
"dance_video": "https://example.com/dance.mp4",
"resolution": "720p"
}
参数说明:
| 参数 |
类型 |
必填 |
说明 |
| model | string | 是 | 使用seedance模型 |
| image | string | 是 | 人物图片URL或base64 |
| dance_video | string | 是 | 舞蹈动作视频URL |
| resolution | string | 否 | 输出分辨率,默认720p |
curl示例:
curl -X POST https://bytesite.xiaojiaixhs.com/v1/videos/seedance \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jiguang-video-seedance-2.0",
"image": "https://example.com/person.jpg",
"dance_video": "https://example.com/dance.mp4",
"resolution": "720p"
}'
注意: Seedance功能需要提供清晰的人物正面照和舞蹈动作视频,生成时间较长(约1-3分钟)
GET /v1/models
获取可用模型列表
curl示例:
curl -X GET https://bytesite.xiaojiaixhs.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"
响应示例:
{
"data": [
{"id": "jiguang-5.0", "type": "image"},
{"id": "jiguang-video-3.5-pro", "type": "video"}
]
}