API Docs

Authentication

Header (required)

Authorization: Bearer YOUR_API_KEY

Create and manage API keys in your dashboard. Register for an account and create an API key from account settings here.

Code	Reason
400	Missing or empty API_KEY header
401	Invalid API_KEY

---

Supported Models

Image Models

Name	Key
GPT Image 1	GPTIMAGE1
Imagen 4	IMAGEN4
Seedream	SEEDREAM
NanoBanana	NANOBANANA

Video Models

Name	Key
Runway Gen-4 (Default)	RUNWAYML
SeeDance I2V	SEEDANCEI2V
Hailuo Img2Vid	HAILUO
Hailuo Pro	HAILUOPRO
Wani I2V	WANI2V
Wani I2V 5B	WANI2V5B
Veo3 I2V	VEO3I2V
Veo3 I2V Fash	VEO3I2VFLASH

---

Pricing

Per-second rates

Model / Item	Credits / sec	Notes
Default (all other)	10	Base rate for most video generation models.
Veo3 I2V Flash	30	Higher-tier accelerated model.
Veo3 I2V	60	Premium Veo3 model with higher fidelity.

Subscription plan

Plan	Included credits / mo	Notes
Creator Plan	$49.99 5 000 credits	Billed monthly
Individual credits can also be purchased from the website $10/1000 credits.

---

Endpoints

POST /create

Creates a new video-generation session.

Request Body Parameters

Field	Type & Constraints	Required	Default	Description
prompt	string (≤ 500 characters)	Yes	—	Text prompt that drives image & video generation.
duration	number seconds (≤ 120)	No	30	Desired video length.
image_model	string GPTIMAGE1 | IMAGEN4 | SEEDREAM	No	GPTIMAGE1	Key for the underlying image-generation model.
video_model	string RUNWAYML | SEEDANCEI2V | HAILUO | HAILUOPRO | WANI2V | WANI2V5B	No	RUNWAYML	Key for the video-synthesis engine.
tone	string grounded | cinematic	No	grounded	Overall stylistic tone of the output.
aspect_ratio	string 9:16 | 16:9	No	16:9	Aspect ratio of the result

Example Request

curl -X POST https://api.samsar.one/v1/video/create \
  -H "Authorization: Bearer 74c4bbbee28e7e221330e48c2cdd897acad510" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "An astronaut cat exploring a neon-lit Mars colony",
      "duration": 30,
      "image_model": "IMAGEN4",
      "video_model": "RUNWAYML",
      "tone": "grounded",
      "aspect_ratio": "16:9"
    }
  }'

Successful Response

{
  "request_id": "vid_1234567890"
}

Code	Reason
201	Session created
400	Validation error
401	Authentication error

Failure Response (Example)

{
  "message": "Invalid movie prompt."
}

---

GET /status

Fetches the current state of a generation session.

Query Parameters

Param	Type	Required	Description
request_id	string	Yes	Identifier returned by /create.

Example Request

curl -X GET "https://api.samsar.one/v1/video/status?request_id=vid_1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

Possible Responses

Scenario	Example Payload	Code
Processing / Pending	See below	200
Completed	{ "video_link": "https://cdn.samsar.one/videos/vid_1234567890.mp4" }	200
Invalid request	{ "message": "Missing or invalid session_id." }	400
Not found	—	404
Authentication error	—	401

Pending Payload Structure

{
  "status": "PENDING",
  "details": {
    "prompt_generation": "COMPLETED",
    "image_generation": "COMPLETED",
    "audio_generation": "COMPLETED",
    "frame_generation": "INIT",
    "video_generation": "INIT",
    "ai_video_generation": "PENDING",
    "speech_generation": "COMPLETED",
    "music_generation": "COMPLETED",
    "lip_sync_generation": "INIT",
    "sound_effect_generation": "INIT",
    "transcript_generation": "INIT"
  }
}

Success Payload Structure

{
  "status": "COMPLETED",
  "url": "https://cdn.samsar.one/videos/vid_1234567890.mp4"
}