Skip to content

Commit 7acdfa3

Browse files
Lookoff-AIMLAPILookoff-AIMLAPI
authored
docs: add alibaba/wan-3-0-video (#498)
1 parent f14fa72 commit 7acdfa3

5 files changed

Lines changed: 439 additions & 1 deletion

File tree

‎docs/SUMMARY.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -488,6 +488,7 @@
488488
* [Wan 2.7 (Text-to-Video)](api-references/video-models/alibaba-cloud/wan-2.7-text-to-video.md)
489489
* [Wan 2.7 (Image-to-Video)](api-references/video-models/alibaba-cloud/wan-2.7-image-to-video.md)
490490
* [Wan 2.7 (Reference-to-Video)](api-references/video-models/alibaba-cloud/wan-2.7-reference-to-video.md)
491+
* [Wan 3.0 Video](api-references/video-models/Alibaba-Cloud/wan-3-0-video.md)
491492
* [Beeble](api-references/video-models/Beeble/README.md)
492493
* [Switchx Video To Video](api-references/video-models/Beeble/switchx-video-to-video.md)
493494
* [Black Forest Labs](api-references/video-models/Black-Forest-Labs/README.md)

‎docs/api-references/model-database.md‎

Lines changed: 1 addition & 1 deletion
Large diffs are not rendered by default.

‎docs/api-references/video-models/Alibaba-Cloud/README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Alibaba Cloud
2+

‎docs/api-references/video-models/Alibaba-Cloud/wan-3-0-video.json‎

Lines changed: 277 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,277 @@
1+
{
2+
"openapi": "3.0.0",
3+
"info": {
4+
"title": "AIML API",
5+
"version": "1.0.0"
6+
},
7+
"servers": [
8+
{
9+
"url": "https://api.aimlapi.com"
10+
}
11+
],
12+
"paths": {
13+
"/v2/video/generations": {
14+
"post": {
15+
"operationId": "_v2_video_generations",
16+
"requestBody": {
17+
"required": true,
18+
"content": {
19+
"application/json": {
20+
"schema": {
21+
"type": "object",
22+
"properties": {
23+
"model": {
24+
"type": "string",
25+
"enum": [
26+
"alibaba/wan-3-0-video"
27+
]
28+
},
29+
"prompt": {
30+
"type": "string",
31+
"maxLength": 20000,
32+
"description": "The text description of the scene, subject, or action to generate in the video."
33+
},
34+
"image_url": {
35+
"type": "string",
36+
"format": "uri",
37+
"description": "The URL of the image strictly used as the first frame of the video. Cannot be used together with reference media, file_url, or link_url."
38+
},
39+
"last_image_url": {
40+
"type": "string",
41+
"format": "uri",
42+
"description": "The URL of the image strictly used as the last frame of the video. Requires image_url."
43+
},
44+
"reference_image_urls": {
45+
"type": "array",
46+
"items": {
47+
"type": "string",
48+
"format": "uri"
49+
},
50+
"maxItems": 10,
51+
"description": "Array of image URLs for multi-image-to-video generation."
52+
},
53+
"video_urls": {
54+
"type": "array",
55+
"items": {
56+
"type": "string",
57+
"format": "uri"
58+
},
59+
"maxItems": 5,
60+
"description": "Reference video URLs. Up to 5 clips with a total duration of no more than 15 seconds."
61+
},
62+
"audio_urls": {
63+
"type": "array",
64+
"items": {
65+
"type": "string",
66+
"format": "uri"
67+
},
68+
"maxItems": 5,
69+
"description": "Reference audio URLs. Up to 5 clips with a total duration of no more than 15 seconds."
70+
},
71+
"file_url": {
72+
"type": "string",
73+
"format": "uri",
74+
"description": "The URL of a document (docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, md) the model uses to generate the video. Cannot be used together with link_url."
75+
},
76+
"link_url": {
77+
"type": "string",
78+
"format": "uri",
79+
"description": "The URL of a publicly accessible web page the model uses to generate the video. Cannot be used together with file_url."
80+
},
81+
"aspect_ratio": {
82+
"type": "string",
83+
"enum": [
84+
"adaptive",
85+
"16:9",
86+
"4:3",
87+
"1:1",
88+
"3:4",
89+
"9:16"
90+
],
91+
"default": "adaptive",
92+
"description": "The aspect ratio of the generated video."
93+
},
94+
"resolution": {
95+
"type": "string",
96+
"enum": [
97+
"480p",
98+
"720p",
99+
"1080p"
100+
],
101+
"default": "1080p",
102+
"description": "An enumeration where the short side of the video frame determines the resolution."
103+
},
104+
"duration": {
105+
"type": "integer",
106+
"description": "The length of the output video in seconds, from 2 to 30. When reference videos are provided, the total input video duration plus the output video duration must not exceed 30 seconds.",
107+
"default": 5
108+
},
109+
"generate_audio": {
110+
"type": "boolean",
111+
"default": true,
112+
"description": "Specifies whether the output video contains audio."
113+
},
114+
"seed": {
115+
"type": "integer",
116+
"description": "Varying the seed integer is a way to get different results for the same other request parameters. Using the same value for an identical request will produce similar results. If unspecified, a random number is chosen."
117+
},
118+
"watermark": {
119+
"type": "boolean",
120+
"default": false,
121+
"description": "Whether the video contains a watermark."
122+
}
123+
},
124+
"required": [
125+
"model",
126+
"prompt"
127+
],
128+
"title": "alibaba/wan-3-0-video"
129+
}
130+
}
131+
}
132+
},
133+
"responses": {
134+
"200": {
135+
"content": {
136+
"application/json": {
137+
"schema": {
138+
"type": "object",
139+
"properties": {
140+
"id": {
141+
"type": "string",
142+
"description": "The ID of the generated video.",
143+
"example": "60ac7c34-3224-4b14-8e7d-0aa0db708325"
144+
},
145+
"status": {
146+
"type": "string",
147+
"enum": [
148+
"queued",
149+
"generating",
150+
"completed",
151+
"error"
152+
],
153+
"description": "The current status of the generation task.",
154+
"example": "completed"
155+
},
156+
"video": {
157+
"anyOf": [
158+
{
159+
"type": "object",
160+
"properties": {
161+
"url": {
162+
"type": "string",
163+
"format": "uri",
164+
"description": "The URL where the file can be downloaded from.",
165+
"example": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
166+
}
167+
},
168+
"required": [
169+
"url"
170+
]
171+
},
172+
{
173+
"type": "array",
174+
"items": {
175+
"type": "object",
176+
"properties": {
177+
"url": {
178+
"type": "string",
179+
"format": "uri",
180+
"description": "The URL where the file can be downloaded from.",
181+
"example": "https://cdn.aimlapi.com/generations/hedgehog/1759866285599-0cdfb138-c03a-49d4-a601-4f6413e27b15.mp4"
182+
}
183+
},
184+
"required": [
185+
"url"
186+
]
187+
}
188+
},
189+
{
190+
"nullable": true
191+
}
192+
]
193+
},
194+
"error": {
195+
"type": "object",
196+
"nullable": true,
197+
"properties": {
198+
"name": {
199+
"type": "string"
200+
},
201+
"message": {
202+
"type": "string"
203+
}
204+
},
205+
"required": [
206+
"name",
207+
"message"
208+
],
209+
"description": "Description of the error, if any."
210+
},
211+
"meta": {
212+
"type": "object",
213+
"nullable": true,
214+
"properties": {
215+
"usage": {
216+
"type": "object",
217+
"nullable": true,
218+
"properties": {
219+
"credits_used": {
220+
"type": "number",
221+
"description": "The number of tokens consumed during generation.",
222+
"example": 120000
223+
},
224+
"usd_spent": {
225+
"type": "number",
226+
"description": "The total amount of money spent by the user in USD.",
227+
"example": 0.06
228+
}
229+
},
230+
"required": [
231+
"credits_used",
232+
"usd_spent"
233+
]
234+
}
235+
},
236+
"description": "Additional details about the generation."
237+
}
238+
},
239+
"required": [
240+
"id",
241+
"status"
242+
]
243+
}
244+
}
245+
},
246+
"description": "Successful response."
247+
}
248+
},
249+
"x-hideTryItPanel": true,
250+
"x-codeSamples": [
251+
{
252+
"lang": "cURL",
253+
"source": "curl --request POST \\\n --url 'https://api.aimlapi.com/v2/video/generations' \\\n --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \\\n --header 'Content-Type: application/json' \\\n --data '{\"model\": \"alibaba/wan-3-0-video\", \"prompt\": \"Describe what you want the model to generate.\", \"image_url\": \"https://example.com/input.jpg\", \"duration\": 5}'"
254+
},
255+
{
256+
"lang": "JavaScript",
257+
"source": "const response = await fetch('https://api.aimlapi.com/v2/video/generations', {\n method: 'POST',\n headers: {\n 'Authorization': 'Bearer <YOUR_AIMLAPI_KEY>',\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n \"model\": \"alibaba/wan-3-0-video\",\n \"prompt\": \"Describe what you want the model to generate.\",\n \"image_url\": \"https://example.com/input.jpg\",\n \"duration\": 5\n}),\n});\n\nconsole.log(await response.json());"
258+
},
259+
{
260+
"lang": "Python",
261+
"source": "import requests\n\nresponse = requests.post(\n \"https://api.aimlapi.com/v2/video/generations\",\n headers={\n \"Authorization\": \"Bearer <YOUR_AIMLAPI_KEY>\",\n \"Content-Type\": \"application/json\",\n },\n json={'model': 'alibaba/wan-3-0-video', 'prompt': 'Describe what you want the model to generate.', 'image_url': 'https://example.com/input.jpg', 'duration': 5},\n)\n\nprint(response.json())"
262+
}
263+
]
264+
}
265+
}
266+
},
267+
"components": {
268+
"securitySchemes": {
269+
"access-token": {
270+
"scheme": "bearer",
271+
"bearerFormat": "<YOUR_AIMLAPI_KEY>",
272+
"type": "http",
273+
"description": "Bearer key"
274+
}
275+
}
276+
}
277+
}

0 commit comments

Comments
 (0)