Skip to content

Lynx

Integrate

Model id bytedance/lynx
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/lynx?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Files like the example: $3.038 3,038 API credits your files are measured before the run Run it on this page

Get API key
ByteDance Image to Video up to 720p #image-to-video#subject

Image-to-video that keeps a subject's identity consistent, with 480p to 720p and 9 to 81 frames

ByteDance · Video

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Text instructions that direct video generation.

•required image_url
Drop a file, or

URL pointing to the subject image used to generate the video.

resolution default 720p

Output video resolution, chosen from 480p, 580p, or 720p.

aspect_ratio default 16:9

Output video aspect ratio, chosen from 16:9, 9:16, or 1:1.

default 16

Output video frame rate in frames per second, restricted to 5 through 30.

default 81

Output video frame count, restricted to 9 through 100.

Advanced negative_prompt · num_inference_steps · ip_scale · strength · guidance_scale · guidance_scale_2 · seed · enable_safety_checker
default Bright tones, overexp...

Describe unwanted video content in this negative prompt to steer generation away from it.

default 50

Sampling step count, trading longer processing time for better quality as the count increases.

default 1

Set how faithfully the video should retain the identity of the person or subject depicted in the reference image.

default 1

Adjust how much the generated video draws on the reference image by setting its scale.

default 5

Classifier-free guidance strength, trading possible quality loss for closer prompt matching as the scale increases.

default 2

Image guidance scale for video generation, balancing reference-image fidelity against quality: increasing the scale favors a closer match but risks lower quality.

Seed that makes generation reproducible. Setting it to None selects a seed randomly.

POST /run/bytedance/lynx?wait=20 quote → $3.038
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/bytedance/lynx?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Lynx

Animates a subject image (`image_url`) following a text `prompt`. Identity preservation is tunable with `ip_scale` and `strength` (both 0 to 2). Resolution can be 480p, 580p or 720p, aspect ratio 16:9, 9:16 or 1:1, and `num_frames` runs from 9 to 81 at 5 to 30 frames per second. Also exposes a negative prompt, two guidance scales, 1 to 75 inference steps and a seed.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
URL pointing to the subject image used to generate the video.
promptrequired
Typestring
Text instructions that direct video generation.
negative_promptoptional
Typestring
DefaultBright tones, overexposed, blurred background, static, subtitles, style, works, paintings, images, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, misshapen limbs, fused fingers, still picture, messy background, three legs, many people in the background, walking backwards
Describe unwanted video content in this negative prompt to steer generation away from it.
num_inference_stepsoptional
Typeinteger
Default50
1 – 75
Sampling step count, trading longer processing time for better quality as the count increases.
seedoptional
Typeinteger | null
Seed that makes generation reproducible. Setting it to None selects a seed randomly.
resolutionoptional
Typeenum
Default720p
480p580p720p
Output video resolution, chosen from 480p, 580p, or 720p.
aspect_ratiooptional
Typeenum
Default16:9
16:99:161:1
Output video aspect ratio, chosen from 16:9, 9:16, or 1:1.
ip_scaleoptional
Typenumber
Default1
0 – 2
Set how faithfully the video should retain the identity of the person or subject depicted in the reference image.
strengthoptional
Typenumber
Default1
0 – 2
Adjust how much the generated video draws on the reference image by setting its scale.
frames_per_secondoptional
Typeinteger
Default16
5 – 30
Output video frame rate in frames per second, restricted to 5 through 30.
guidance_scaleoptional
Typenumber
Default5
1 – 20
Classifier-free guidance strength, trading possible quality loss for closer prompt matching as the scale increases.
guidance_scale_2optional
Typenumber
Default2
0 – 10
Image guidance scale for video generation, balancing reference-image fidelity against quality: increasing the scale favors a closer match but risks lower quality.
num_framesoptional
Typeinteger
Default81
9 – 81
Output video frame count, restricted to 9 through 100.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "bytedance/lynx",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 3038,
    "usd": "3.038",
    "charged": 3038,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}Resulting video file.
seed
integerSeed value used during generation.

More models: Image to Video

For AI agents: this page as Markdown is at https://doitong.com/developers/models/bytedance/lynx.md. All models and guides: https://doitong.com/developers/llms.txt