PiAPI
HomeWorkspace
HomeWorkspace
Join Discord
  1. Framepack
  • Get Started
    • Overview
    • Quickstart
    • Make Instruction: How to Use PiAPI to Build a Workflow on Make?
  • Endpoints
    • Song(Udio)
      • Song API Task Creation Examples
      • [Udio] Song Extend
      • Get Task
      • Create Task
      • [Udio] Generate Lyrics
    • Kling
      • Lipsync With PiAPI Kling API Examples
      • Motion Brush With PiAPI Kling API Example
      • Kling Elements Video Generation API
      • Kling Effects Video Generation
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Get Task
      • Create Task
      • Kling Virtual Try-On
    • Hailuo
      • Hailuo Director Mode Example
      • Generate Video
      • Get Task
    • Flux
      • Flux with LoRA and Controlnet
      • Available LoRA and Controlnet
      • Flux API with Redux Variation, Fill, Inpaint and Outpaint
      • Create Task
        • Text to Image
        • Image to Image
      • Get task
    • AI Hug
      • Get Task
      • Create Task
    • LLM
      • Use Cases for GPT-4o Image API
      • How To Avoid Timeouts in Completion API
      • GPT-4o Image Generation API
      • LLM API | Basic Completions
      • Get Task
    • Midjourney
      • PiAPI Penalties on Midjourney Usage
      • Detailed Explaination on Midjourney Task Result
      • Midjourney V7 API Instructions
      • Create Task
        • Imagine
        • Upscale
        • Variation
        • Reroll
        • Describe
        • Seed
        • Blend
        • Inpaint
        • Outpaint
        • Pan
      • Cancel Task
        • Cancel Task
        • Cancel Tasks
      • Get Task
    • Faceswap
      • Multi Faceswap
      • Image Faceswap
      • Video Faceswap
      • Get Task
    • TTS
      • Zeroshot Text-to-Speech F5-TTS
      • Get Task
    • Trellis
      • Create Task
      • Get Task
    • Luma Dream Machine
      • Cancel Task
        • Cancel Tasks
        • Cancel Task
      • Create Task
      • Get Task
    • WanX
      • Available LoRA Types for Wanx
      • Generate WanX Task with LoRA Using PiAPI
      • Use Cases for Wanx LoRA
      • Create Task
      • Get Task
    • Skyreels
      • Create Task
      • Get Task
    • Framepack
      • Create Task
        POST
      • Get Task
        GET
    • Hunyuan Video
      • How to Make a Hunyuan API Call
      • Get Task
      • Generate Video
    • Mmaudio
      • Get Task
      • Generate Audio
    • DiffRhythm
      • Generate Audio
      • Get Task
    • Tools
      • File Upload API
      • Video Upscale
      • Video Upscale-Get Task
      • Remove Background API
      • Remove Background-Get Task
      • Segment With Prompt API
      • Segment With Prompt API-Get Task
      • Image Upscale(Super Resolution) API
      • Image Upscale-Get Task
    • PiAPI Account Management
      • PiAPI Account Info
      • Task List Info
      • User Task History
  • Resources
    • Change Log
    • Output Storage
    • Unified API Schema
    • Webhook
    • Bulk Generation Service
    • Billings
    • PiAPI MCP Server
    • Workspace Manual
      • Host-your-account (HYA) | Back-up Account
      • Host-your-account (HYA) | Debug Checklist
      • Host-your-account (HYA) | Connected Account Status
    • Announcements
      • PiAPI 2025 January 1st Pricing Update
  • Legacy Documentation
    • Midjourney
      • Midjourney Webhook
      • Imagine
      • Reroll
      • Upscale
      • Variation
      • Inpaint
      • Outpaint
      • Pan
      • Describe
      • Blend
      • Seed
      • Fetch
      • Multi Fetch
      • Cancel
    • Face Swap
      • Video Faceswap
      • Multi-face-swap
      • Fetch
    • Dream Machine
      • Video Generation
      • Video Extend
      • Get Video Generation
    • Kling
      • Video Generation
      • Video Extend
      • Get Video Generation
  1. Framepack

Create Task

POST
/api/v1/task
Video Generation

Introduction#

The Framepack Img2Video API allows you to generate videos from static images. This model is specially trained for long video generation

Model Information#

Model: Qubico/framepack
Task Type: img2video
Description: Transforms static images into high-quality videos based on text and image prompts.

Pricing#

$0.03 per second

Important Notes#

Image Requirements#

The input image can be provided as a URL or base64 encoded string.
For best results, provide clear images with good lighting and minimal background distractions.
Faces and human subjects generally produce the best results.

Video Generation Guidelines#

Use detailed prompts to guide the video generation process.
Include specific motion descriptions in your prompt (e.g., "camera zooms in slowly," "gentle breeze moving hair").
The negative prompt can help avoid undesired artifacts or motions.

Duration#

duration in seconds of the generated video
fps of the generated video sticks to 30

Request

Header Params
x-api-key
string 
required
your api key
Body Params application/json
model
string 
required
Model to use for generation
Example:
Qubico/framepack
task_type
string 
required
Type of task to perform
Example:
img2video
input
object 
required
prompt
string 
required
Description of the video to generate
Example:
The camera zooms in, a video of a young woman with long, dark hair and bangs. She is wearing a light gray t-shirt and appears to be sitting at a table.
negative_prompt
string 
optional
Description of elements to avoid in the generated video
Example:
chaotic, distortion, morphing
start_image
string 
required
URL or base64 encoded image to transform into video, used as first frame
Example:
https://i.ibb.co/wbw9GLY/girl.webp
end_image
string 
optional
URL or base64 encoded image to transform into video, used as end frame
Example:
https://i.ibb.co/wbw9GLY/girl.webp
duration
integer 
optional
The duration (in seconds) of the generated video
>= 10<= 30
Default:
10
config
object 
optional
webhook_config
object 
optional
Example
{
  "model": "Qubico/framepack",
  "task_type": "img2video",
  "input": {
    "prompt": "The camera zooms in, a video of a young woman with long, dark hair and bangs. She is wearing a light gray t-shirt and appears to be sitting at a table.",
    "negative_prompt": "chaotic, distortion, morphing",
    "start_image": "https://i.ibb.co/wbw9GLY/girl.webp",
    "end_image": "https://i.ibb.co/wbw9GLY/girl.webp",
    "duration": 10
  }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.piapi.ai/api/v1/task' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "Qubico/framepack",
    "task_type": "img2video",
    "input": {
        "prompt": "The camera zooms in, a video of a young woman with long, dark hair and bangs. She is wearing a light gray t-shirt and appears to be sitting at a table.",
        "negative_prompt": "chaotic, distortion, morphing",
        "start_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "end_image": "https://i.ibb.co/wbw9GLY/girl.webp",
        "duration": 10
    }
}'

Responses

🟢200OK
application/json
Successful operation
Body
task_id
string 
optional
Unique identifier for the task
status
enum<string> 
optional
Current status of the task
Allowed values:
pendingprocessingcompletedfailed
created_at
string <date-time>
optional
Timestamp when the task was created
Example
{
  "task_id": "string",
  "status": "pending",
  "created_at": "2019-08-24T14:15:22Z"
}
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2025-05-08 02:02:44
Previous
Get Task
Next
Get Task