Skip to main content
POST
/
chat
/
completions
curl -X POST https://api.blackbox.ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
    "model": "veo-2",
    "messages": [
        {
            "role": "user",
            "content": "tesla car moving on a high way"
        }
    ]
}'

{
  "id":"chatcmpl-1757152743",
  "created":1757152743,
  "model":"veo-2:0546b4e90d4f215c7fc42c9b8d815df3a7b6e47a754ee94ddb62b3f667fea9a5",
  "object":"chat.completion",
  "system_fingerprint":"None",
  "choices":[
    {
      "finish_reason":"stop",
      "index":0,
      "message":{
        "content":"https://replicate.delivery/xezq/6gaMWJQRMt4fJyA4Pbgd6fNyhHTHBLoSzq6fVdkxGjff8bTqC/tmp19truo4m.mp4",
        "role":"assistant",
        "tool_calls":"None",
        "function_call":"None"
      }
    }
  ],
  "usage":{
    "completion_tokens":0,
    "prompt_tokens":0,
    "total_tokens":0,
    "completion_tokens_details":"None",
    "prompt_tokens_details":"None"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows you to generate a high-quality videos based on a descriptive text prompt. Its similar to the chat POST request - just that response.choices.message.content contains the URL for video generated

​
Headers

​
Authorization
string
required
API Key of the from Bearer <api_key>, you can get it from here.

​
Request

​
model
string
required
The model to use for video generation, e.g., “veo-2”
​
messages
array
required
An array of message objects. For image generation, provide a single message with role “user” and content as the descriptive text prompt.

​
Tips for Better Results

  • Describe the scene, action, and camera movements
  • Specify duration and pacing if relevant
  • Include details about transitions and visual effects
curl -X POST https://api.blackbox.ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
    "model": "veo-2",
    "messages": [
        {
            "role": "user",
            "content": "tesla car moving on a high way"
        }
    ]
}'

{
  "id":"chatcmpl-1757152743",
  "created":1757152743,
  "model":"veo-2:0546b4e90d4f215c7fc42c9b8d815df3a7b6e47a754ee94ddb62b3f667fea9a5",
  "object":"chat.completion",
  "system_fingerprint":"None",
  "choices":[
    {
      "finish_reason":"stop",
      "index":0,
      "message":{
        "content":"https://replicate.delivery/xezq/6gaMWJQRMt4fJyA4Pbgd6fNyhHTHBLoSzq6fVdkxGjff8bTqC/tmp19truo4m.mp4",
        "role":"assistant",
        "tool_calls":"None",
        "function_call":"None"
      }
    }
  ],
  "usage":{
    "completion_tokens":0,
    "prompt_tokens":0,
    "total_tokens":0,
    "completion_tokens_details":"None",
    "prompt_tokens_details":"None"
  }
}