https://api.neural4d.com/openapi/v1 基础路径。每个请求都需要携带 API 密钥。
上传参考文件
通过POST /files 上传一个本地图片或视频，并保存返回的文件 id，供生成请求引用。
curl --request POST \
--url 'https://api.neural4d.com/openapi/v1/files' \
--header 'Authorization: Bearer ${YOUR_API_KEY}' \
--form 'file=@first-frame.png'
import os
import requests
with open("first-frame.png", "rb") as file:
response = requests.post(
"https://api.neural4d.com/openapi/v1/files",
headers={"Authorization": f"Bearer {os.environ['YOUR_API_KEY']}"},
files={"file": ("first-frame.png", file, "image/png")},
)
print(response.json())
import { openAsBlob } from "node:fs";
const form = new FormData();
form.append("file", await openAsBlob("first-frame.png"), "first-frame.png");
const response = await fetch("https://api.neural4d.com/openapi/v1/files", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.YOUR_API_KEY}` },
body: form,
});
console.log(await response.json());
package main
import (
"bytes"
"fmt"
"io"
"mime/multipart"
"net/http"
"os"
"path/filepath"
)
func main() {
file, _ := os.Open("first-frame.png")
defer file.Close()
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", filepath.Base(file.Name()))
_, _ = io.Copy(part, file)
_ = writer.Close()
request, _ := http.NewRequest("POST", "https://api.neural4d.com/openapi/v1/files", body)
request.Header.Set("Authorization", "Bearer "+os.Getenv("YOUR_API_KEY"))
request.Header.Set("Content-Type", writer.FormDataContentType())
response, _ := http.DefaultClient.Do(request)
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Println(string(result))
}
201 Created
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"filename": "first-frame.png",
"bytes": 245760,
"mime_type": "image/png",
"created_at": 1784044800
}
创建视频
向POST /videos/generations 提交 JSON 请求。首帧和尾帧图片放入 frame_images，其他图片、视频或音频参考素材放入 input_references。Seedance 2.0、Seedance 2.0 Fast 和 Veo 3.1 可通过 output_with_audio 控制是否生成原生音频；xai/grok-imagine 不支持此参数。支持的模型省略此参数时，使用该模型的当前默认值。以下示例通过文件 ID 引用已上传的首帧图片。接口返回 202 Accepted 和任务 ID。
curl --request POST \
--url 'https://api.neural4d.com/openapi/v1/videos/generations' \
--header 'Authorization: Bearer ${YOUR_API_KEY}' \
--header 'Content-Type: application/json' \
--data '{
"model": "bytedance/seedance-2.0-fast",
"prompt": "夜晚穿行霓虹街道的电影感跟拍镜头",
"frame_images": [
{
"type": "image",
"frame_type": "first_frame",
"file_id": "550e8400-e29b-41d4-a716-446655440000"
}
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"output_with_audio": true,
"n": 1
}'
import os
import requests
response = requests.post(
"https://api.neural4d.com/openapi/v1/videos/generations",
headers={"Authorization": f"Bearer {os.environ['YOUR_API_KEY']}"},
json={
"model": "bytedance/seedance-2.0-fast",
"prompt": "夜晚穿行霓虹街道的电影感跟拍镜头",
"frame_images": [
{
"type": "image",
"frame_type": "first_frame",
"file_id": "550e8400-e29b-41d4-a716-446655440000",
},
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"output_with_audio": True,
"n": 1,
},
)
print(response.json())
const response = await fetch("https://api.neural4d.com/openapi/v1/videos/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.YOUR_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "bytedance/seedance-2.0-fast",
prompt: "夜晚穿行霓虹街道的电影感跟拍镜头",
frame_images: [
{
type: "image",
frame_type: "first_frame",
file_id: "550e8400-e29b-41d4-a716-446655440000",
},
],
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
output_with_audio: true,
n: 1,
}),
});
console.log(await response.json());
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{"model":"bytedance/seedance-2.0-fast","prompt":"夜晚穿行霓虹街道的电影感跟拍镜头","frame_images":[{"type":"image","frame_type":"first_frame","file_id":"550e8400-e29b-41d4-a716-446655440000"}],"duration":5,"resolution":"720p","aspect_ratio":"16:9","output_with_audio":true,"n":1}`)
request, _ := http.NewRequest("POST", "https://api.neural4d.com/openapi/v1/videos/generations", bytes.NewReader(body))
request.Header.Set("Authorization", "Bearer "+os.Getenv("YOUR_API_KEY"))
request.Header.Set("Content-Type", "application/json")
response, _ := http.DefaultClient.Do(request)
defer response.Body.Close()
result, _ := io.ReadAll(response.Body)
fmt.Println(string(result))
}
202 Accepted
{
"id": "normal-video-c50fe63e-699d-4d61-93f5-2099ab159d6d",
"status": "queued",
"created_at": 1784044800,
"mode": "first_frame_image_to_video",
"model": "bytedance/seedance-2.0-fast",
"data": [
{
"uuid": "7d1fa4bb-41e6-4a5d-88d8-1851f5342e87",
"status": "queued",
"created_at": 1784044800
}
]
}
查询任务
将批次任务id 或视频子项 uuid 中的一个传给 GET /tasks/task-info，不能同时传入。轮询直到 status 变为 succeeded 或 failed。output.videos 中的每个子项都会返回 UUID、宽高比、原生音频标识、生成模式、状态和时间。
cURL
curl --request GET \
--url 'https://api.neural4d.com/openapi/v1/tasks/task-info?id=normal-video-c50fe63e-699d-4d61-93f5-2099ab159d6d' \
--header 'Authorization: Bearer ${YOUR_API_KEY}'
uuid 代替 id：GET /openapi/v1/tasks/task-info?uuid=7d1fa4bb-41e6-4a5d-88d8-1851f5342e87。
200 OK
{
"id": "normal-video-c50fe63e-699d-4d61-93f5-2099ab159d6d",
"status": "succeeded",
"mode": "first_frame_image_to_video",
"model": "bytedance/seedance-2.0-fast",
"created_at": 1784044800,
"updated_at": 1784044842,
"output": {
"videos": [
{
"uuid": "7d1fa4bb-41e6-4a5d-88d8-1851f5342e87",
"url": "https://cdn.neural4d.com/results/video.mp4",
"format": "mp4",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"has_audio": true,
"mode": "first_frame_image_to_video",
"status": "succeeded",
"created_at": 1784044800,
"updated_at": 1784044842
}
]
}
}