Skip to main content
POST
/
videos
/
generate
curl --request POST \ --url https://rawugc.com/api/v1/videos/generate \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "sora-2-text-to-video", "prompt": "A serene beach at sunset with gentle waves", "aspectRatio": "landscape", "nFrames": "15" } '
{
  "videoId": "<string>",
  "model": "<string>",
  "status": "pending",
  "creditsUsed": 123,
  "newBalance": 123,
  "estimatedCompletionTime": "<string>",
  "createdAt": 123
}

Authorizations

​
Authorization
string
header
required

Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY

Headers

​
RawUGC-Version
string

API version to use for this request (date string, e.g. '2026-03-06'). If omitted, uses your API key's pinned version or the latest version.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-03-06"

Body

application/json
​
model
enum<string>
required

AI model to use for video generation

Available options:
sora-2-text-to-video,
sora-2-image-to-video,
kling-2.6/motion-control,
veo3,
veo3_fast
​
prompt
string

Text description of the video to generate. Required for text-to-video models (sora-2-text-to-video, veo3, veo3_fast).

Required string length: 1 - 5000
​
imageUrls
string<uri>[]

Array of image URLs. Required for sora-2-image-to-video and kling-2.6/motion-control.

Maximum array length: 10
​
videoUrls
string<uri>[]

Array of reference video URLs. Required for kling-2.6/motion-control.

Maximum array length: 1
​
aspectRatio
enum<string>

Video aspect ratio. Sora models use portrait/landscape. Veo models use 16:9, 9:16, or Auto.

Available options:
portrait,
landscape,
16:9,
9:16,
Auto
​
nFrames
enum<string>

Video length in seconds (Sora models only)

Available options:
10,
15
​
characterOrientation
enum<string>

Character orientation mode for kling-2.6/motion-control. 'image' = 10s max, 'video' = 30s max.

Available options:
image,
video
​
mode
enum<string>

Output resolution for kling-2.6/motion-control

Available options:
720p,
1080p
​
selectedCharacter
string

Character username to use (e.g., 'rawugc.mia')

Response

Video generation initiated successfully

​
videoId
string

Unique video identifier (vid_xxx format)

​
model
string

Model used for generation

​
status
enum<string>

Current generation status

Available options:
pending,
processing,
completed,
failed
​
creditsUsed
number

Number of credits deducted for this generation

​
newBalance
number

Remaining credit balance after deduction

​
estimatedCompletionTime
string

Estimated time until video is ready (human-readable)

​
createdAt
number

Timestamp when generation was initiated (milliseconds since epoch)