Crayo API documentation

1. 1Confirm the key works and read your credit balances.GET/v1/account

   curl "https://api.crayo.ai/v1/account" \
     -H "Authorization: Bearer $CRAYO_API_KEY"

2. 2Bring a long video into your library from a public https URL.POST/v1/assets

   curl -X POST "https://api.crayo.ai/v1/assets" \
     -H "Authorization: Bearer $CRAYO_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "url": "https://example.com/media/hook-clip.mp4",
     "name": "Hook clip"
   }'

3. 3Start an AutoClip job on that asset.POST/v1/autoclip

   curl -X POST "https://api.crayo.ai/v1/autoclip" \
     -H "Authorization: Bearer $CRAYO_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "asset_id": "cm7x1k2p40001abcd",
     "clip_count": 5,
     "clip_length": 60,
     "edit_level": "full"
   }'

4. 4Poll the job, or register an autoclip.completed webhook, then export each clip by its project_id.GET/v1/autoclip/{id}

   curl "https://api.crayo.ai/v1/autoclip/cm7x1m8880001abcd" \
     -H "Authorization: Bearer $CRAYO_API_KEY"

Long-running work (renders, AutoClip, speech enhancement, tracker refreshes) finishes in the background. Register a webhook with POST /v1/webhooks instead of polling on a timer.