Interpolate Video

April 2, 2026

Table of contents

  1. Request Headers
  2. Request Body
  3. Responses
  4. Examples
  5. Try It

Interpolate a generated video to higher frame rate (30 or 60 FPS from the original 24 FPS). Creates smoother motion by generating intermediate frames.

Requires a completed video generation or video upscale job. Each video can only be interpolated once. You can interpolate both original and upscaled videos.

Interpolation is asynchronous — poll GET /videos/jobid for the result.

https://api.useapi.net/v1/dreamina/videos/interpolate

Request Headers 

Authorization: Bearer {API token}
Content-Type: application/json

Request Body 

{
  "jobid": "j0302140530123456789v-u12345-CA:[email protected]:dreamina",
  "fps": 60
}
  • jobid is required. The job ID of a completed video generation job from POST /videos or a completed video upscale job from POST /videos/upscale.
  • fps is required. Target frame rate. Supported values: 30, 60.
  • replyUrl is optional, webhook URL for job status callbacks.
  • replyRef is optional, custom reference string passed back in webhook callbacks.
  • maxJobs is optional, override max concurrent jobs for this request (1-50).

Responses

  • 200 OK

    Interpolation job created. Poll GET /videos/jobid for the result.

    {
  "jobid": "j0302140630123456789F-u12345-CA:[email protected]:dreamina",
  "type": "video-interpolate",
  "status": "created",
  "model": "seedance-2.0-fast",
  "created": "2026-04-02T10:06:30.123Z",
  "request": {
    "jobid": "j0302140530123456789v-u12345-CA:[email protected]:dreamina",
    "fps": 60
  },
  "response": {
    "forecastCost": 66
  },
  "code": 200
}

  • 400 Bad Request

    Validation error.

    {
  "error": "Source video job is created, must be completed"
}

    {
  "error": "Source video already interpolated: j0302140630123456789F-u12345-CA:[email protected]:dreamina"
}

    {
  "error": "Parameter fps (24) valid values: 30, 60"
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "Unauthorized"
}

  • 404 Not Found

    Source video job not found.

    {
  "error": "Source video job not found"
}

Examples 

  • # Interpolate a generated video to 60 FPS
curl -X POST \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "jobid": "YOUR_COMPLETED_VIDEO_JOBID",
       "fps": 60
     }' \
     "https://api.useapi.net/v1/dreamina/videos/interpolate"

# Interpolate an upscaled video to 30 FPS
curl -X POST \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "jobid": "YOUR_COMPLETED_UPSCALE_JOBID",
       "fps": 30
     }' \
     "https://api.useapi.net/v1/dreamina/videos/interpolate"

  • const token = 'YOUR_API_TOKEN';

const response = await fetch('https://api.useapi.net/v1/dreamina/videos/interpolate', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    jobid: 'YOUR_COMPLETED_VIDEO_JOBID',
    fps: 60
  })
});

const result = await response.json();
console.log('Interpolate job:', result.jobid);

// Poll for completion
const poll = async (jobid) => {
  while (true) {
    const res = await fetch(`https://api.useapi.net/v1/dreamina/videos/${jobid}`, {
      headers: { 'Authorization': `Bearer ${token}` }
    });
    const job = await res.json();
    if (job.status === 'completed') {
      console.log('Video URL:', job.response.videoUrl);
      return job;
    }
    if (job.status === 'failed') throw new Error(job.error);
    await new Promise(r => setTimeout(r, 10000));
  }
};

await poll(result.jobid);

  • import requests
import time

token = 'YOUR_API_TOKEN'

response = requests.post(
    'https://api.useapi.net/v1/dreamina/videos/interpolate',
    headers={
        'Authorization': f'Bearer {token}',
        'Content-Type': 'application/json'
    },
    json={
        'jobid': 'YOUR_COMPLETED_VIDEO_JOBID',
        'fps': 60
    }
)

result = response.json()
print(f"Interpolate job: {result['jobid']}")

# Poll for completion
jobid = result['jobid']
while True:
    job = requests.get(
        f'https://api.useapi.net/v1/dreamina/videos/{jobid}',
        headers={'Authorization': f'Bearer {token}'}
    ).json()

    if job['status'] == 'completed':
        print(f"Video URL: {job['response']['videoUrl']}")
        break
    if job['status'] == 'failed':
        raise Exception(job.get('error'))

    time.sleep(10)

Try It