Video Embedding (CLIP)
studio-embed-videoSample video frames → list of 512-dim CLIP vectors.
POST
/v1/proxy/studio-embed-videoSample and encode video frames with CLIP
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
videoUrl | string | required | Public URL of the source video |
sample_fps | number | optional | Frames per second to sample (default 1.0). Lower = fewer frames = faster. |
max_frames | integer | optional | Optional cap on frame count (default: no limit) |
curl -X POST https://api.cn8.io/v1/proxy/studio-embed-video \
-H "X-API-Key: <cn8_api_key>" \
-H "Content-Type: application/json" \
-d '{"videoUrl":"https://example.com/file"}'Response
{
"status": "success",
"data": {
"status": "success",
"embeddings": [[0.023, -0.045, ...], [...]],
"frame_count": 60,
"dim": 512,
"sample_fps": 1.0,
"max_frames": null
},
"cost": { "units": 1, "unit_price": 0.02, "tokens": 0.02, "balance": 99.99 },
"gateway": { "request_id": "req_abc", "service": "studio-embed-video" }
}
Billing: 2 credits per video. Synchronous. Store embeddings with frame timestamps for semantic video search.