Use a public image or video as a reference for your Seedance video. You only need:
- Your Flatkey API Key
- A public HTTPS link to the image or video
This page uses a video as the example. Replace YOUR_FLATKEY_API_KEY with the API Key from your Flatkey console.
1. Create the reference asset
Paste your public video link into url and run:
The response contains an id that starts with ast_:
Copy this id. You will use it in the next steps.
2. Wait until the asset is ready
Put your asset ID at the end of the URL and run:
When you see "status": "Active", continue to step 3. If you still see Processing, wait a few seconds and run the same command again.
3. Create the Seedance video
Add asset:// before the asset ID, describe the video you want, and run:
Copy the returned video task id, which starts with task_.
Using an image instead? In step 1, change Video to Image. In step 3, change both video_url values to image_url, and change reference_video to reference_image.
4. Get the finished video
Put your video task ID at the end of the URL and run:
If the status is queued or in_progress, wait a few seconds and run the same command again. When the status is completed, open the link in metadata.url to download the video.
If something does not work
- Make sure the reference link starts with
https:// and opens without signing in.
- Wait until the asset status is
Active before creating the video.
- Make sure you copied the full
ast_... or task_... ID.
- Use the same Flatkey API Key for every step.
Need every available option? See the Seedance API Reference. 
