curl -X POST "https://t.ato2.nodesms.com/v1/video/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720
}'
import requests
response = requests.post(
"https://t.ato2.nodesms.com/v1/video/generations",
headers={"Authorization": "Bearer sk-xxxxx"},
json={
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720,
},
)
print(response.json())
{
"task_id": "string",
"status": "string"
}
{
"error": {
"message": "string",
"type": "string",
"param": null,
"code": null
}
}
Create Video Generation Task
Submit a video generation task, supporting text-to-video and image-to-video. Returns a task ID that can be used to query task status via the GET endpoint.
POST
/
v1
/
video
/
generations
curl -X POST "https://t.ato2.nodesms.com/v1/video/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720
}'
import requests
response = requests.post(
"https://t.ato2.nodesms.com/v1/video/generations",
headers={"Authorization": "Bearer sk-xxxxx"},
json={
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720,
},
)
print(response.json())
{
"task_id": "string",
"status": "string"
}
{
"error": {
"message": "string",
"type": "string",
"param": null,
"code": null
}
}
Headers
string
required
Bearer token authentication. Format:
Authorization: Bearer sk-xxxxxxBody
Format:application/json
string
Model/style ID.
string
Text description prompt.
string
Image input (URL or Base64).
number
Video duration (seconds).
integer
Video width.
integer
Video height.
integer
Video frame rate.
integer
Random seed.
integer
Number of videos to generate.
string
Response format.
string
User identifier.
object
Extended parameters (such as negative_prompt, style, quality_level, etc.).
Show Properties
Show Properties
any
Arbitrary key-value pairs, where keys are strings and values are of any type.
Response
200 Video generation task created successfully
Format:application/json
string
Task ID.
string
Task status.
400 Request parameter error
Format:application/json
object
curl -X POST "https://t.ato2.nodesms.com/v1/video/generations" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720
}'
import requests
response = requests.post(
"https://t.ato2.nodesms.com/v1/video/generations",
headers={"Authorization": "Bearer sk-xxxxx"},
json={
"model": "sora",
"prompt": "A cute cat playing in the garden",
"duration": 5,
"width": 1280,
"height": 720,
},
)
print(response.json())
{
"task_id": "string",
"status": "string"
}
{
"error": {
"message": "string",
"type": "string",
"param": null,
"code": null
}
}
Last modified on October 28, 2026
Was this page helpful?