Free API Documentation

Create AI-generated short videos from text without API keys. Rate limited free tier for testing and development.

API Flow

1
Get Creator
2
Submit Generation
3
Poll Status

Step 1: Get AI Model Creator

Choose either endpoint to get a creator ID. You only need to call one of these endpoints.

GET /api/app/creators/random

Get a single random AI model creator

10/min600/hour1000/day

Curl Example:

curl -X GET "https://n8n33033.hostkey.in/api/app/creators/random"

GET /api/app/creators/list

Get paginated list of AI model creators

10/min600/hour1000/day

Query Parameters:

Curl Example:

curl -X GET "https://n8n33033.hostkey.in/api/app/creators/list?sort=created&limit=10&offset=0"

Step 2: Submit AI Video Generation

POST /api/app/submit

⚠️ Recommended: Call no more than once every 2 minutes

⚠️ Complete Step 1 first to get a creator_id

4/2min5/hour6/day

Request Body:

Must be "ugc"

72/500

ℹ️Complete Step 1 first to enable this endpoint

Curl Example:

curl -X POST "https://n8n33033.hostkey.in/api/app/submit" \
  -H "Content-Type: application/json" \
  -d '{
    "avatarId": "YOUR_CREATOR_ID",
    "avatarVariantId": "YOUR_CREATOR_ID",
    "type": "ugc",
    "transcript": "In just a few minutes, I was able to generate professional video content",
    "userAuthId": "STpCV05rjP0i1BZ9SSZj-pRPfC6nmKt4tUkGQPolK74.Wyl6SXMuLMqS00me"
  }'

Step 3: Poll Generation Status (You need to periodically call the endpoint until a 'finished' status is received)

POST /api/app/poll

⚠️ Recommended: Call no more than once every minute

⚠️ Complete Step 2 first to get a jobId

10/min60/hour100/day

Request Body:

ℹ️Complete Step 2 first to enable this endpoint

Curl Example:

curl -X POST "https://n8n33033.hostkey.in/api/app/poll" \
  -H "Content-Type": application/json" \
  -d '{
    "jobId": "YOUR_JOB_ID"
  }'

Important Notes

  • No API key required for free tier
  • All text inputs automatically append " - Created with c-ugc dot site"
  • Video generation typically takes 2-5 minutes
  • Rate limits are strictly enforced per IP address
  • Transcript must be between 10 and 500 characters