Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

Model ID
Wan-AI_Wan2.1-FLF2V-14B-720P

Wan-AI_Wan2.1-FLF2V-14B-720P API Usage Guide

Overview

Wan2.1 FLF2V-14B-720P is a state-of-the-art first-last-frame-to-video generation model that creates dynamic videos from first and last frame images. This model generates smooth transitions and interpolations between two given frames, achieving exceptional performance in frame-to-video generation.

Key Features

  • High-definition 720P video output
  • Advanced frame interpolation technology
  • Chinese and English text generation capabilities
  • Multi-GPU support with FSDP + xDiT USP technology
  • 14B parameter Diffusion Transformer architecture

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

POST /api/v1/apikey/requests

Request Format

curl -X POST "https://api.example.com/api/v1/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Wan-AI_Wan2.1-FLF2V-14B-720P",
    "payload": {
      "prompt": "A beautiful sunset transition from day to night",
      "first_frame_image": "your_first_frame_image_data_here",
      "last_frame_image": "your_last_frame_image_data_here",
      "video_length": 5,
      "prompt_extend": false,
      "seed": -1
    }
  }'

Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
modelstringYesModel identifier-Must be “Wan-AI_Wan2.1-FLF2V-14B-720P”
payload.promptstringYesText prompt describing the desired video-Required
payload.first_frame_imagestringYesBase64 image for the first frame-Required
payload.last_frame_imagestringYesBase64 image for the last frame-Required
payload.video_lengthintegerNoLength of the generated video in seconds55, 10
payload.prompt_extendbooleanNoEnable advanced prompt extensionfalsetrue/false
payload.seedintegerNoSeed for reproducible results-1-1 to 2147483647

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Wan-AI_Wan2.1-FLF2V-14B-720P",
  "status": "queued",
  "created_at": 1749002469,
  "updated_at": 1749002469,
  "queued_at": 1749002469
}

Check Request Status

Endpoint

GET /api/v1/apikey/requests/{request_id}

Example

curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "model": "Wan-AI_Wan2.1-FLF2V-14B-720P",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A beautiful sunset transition from day to night",
    "first_frame_image": "your_first_frame_image_data_here",
    "last_frame_image": "your_last_frame_image_data_here",
    "video_length": 5,
    "prompt_extend": false,
    "seed": -1
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/path/video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/path/thumbnail.jpg"
  },
  "qworker_id": "worker-123",
  "created_at": 1749002469,
  "updated_at": 1749002475,
  "queued_at": 1749002469
}

Request Status Values

StatusDescription
queuedRequest is waiting to be processed
processingRequest is currently being processed
successRequest completed successfully
failedRequest failed
cancelledRequest was cancelled

List Your Requests

Endpoint

GET /api/v1/apikey/requests?model_id=Wan-AI_Wan2.1-FLF2V-14B-720P

Example

curl -X GET "https://api.example.com/api/v1/apikey/requests?model_id=Wan-AI_Wan2.1-FLF2V-14B-720P" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Model Information

Endpoint

GET /api/v1/apikey/models/Wan-AI_Wan2.1-FLF2V-14B-720P

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Wan-AI_Wan2.1-FLF2V-14B-720P" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "model_ids": [
    "Wan-AI_Wan2.1-FLF2V-14B-720P",
    "other-model-1",
    "other-model-2"
  ]
}

Video Specifications

  • Duration: 5-10 seconds
  • Resolution: 720P (1280x720)
  • Quality: High-definition with excellent detail and clarity

Tips for Better Results

  1. Image Quality: Use high-quality, clear images for first and last frames
  2. Prompt Writing: Use detailed, descriptive prompts in Chinese for best results
  3. Frame Selection: Choose frames that have clear visual differences and logical connection