Skip to main content
MaxAPI provides OpenAI-compatible endpoints and provider-native formats. They use the same account system, but their paths, request fields, and response shapes can differ.

​
Quick selection

If both formats support your use case, choose the one your client already supports. This reduces request and response conversion code.

​
Confirm the base URL

The OpenAI SDK base_url normally includes /v1:
For a direct HTTP request, use the complete path shown on the endpoint page:
Do not automatically add /v1 to provider-native paths. Append paths such as /wan/*, /kling/*, and /vidu/* directly to https://api.maxapi.ai.

​
Choose in this order

1

Confirm the client protocol

Check whether your SDK or application supports OpenAI, Google, or a provider-native format. An existing OpenAI client usually requires only a different base URL, API key, and model ID.
2

Confirm the model capability

Copy the model ID from the MaxAPI console. Confirm that the model supports the text, image, video, audio, or music capability you need.
3

Confirm how results are delivered

A synchronous endpoint returns its result in the current response. An asynchronous endpoint returns a task ID that you use with a matching query endpoint.
4

Check the endpoint schema

Open the endpoint page and verify its authentication header, content type, required fields, and response example. Do not reuse request bodies across providers without adapting them.

​
Keep request formats separate

The same capability can have several API formats. For example, video APIs may use id, task_id, or taskId for a task identifier and may define different status values.
  • Read the task ID field returned by the create endpoint.
  • Use the query endpoint from the same API family.
  • Interpret success and failure states according to that query endpoint.
  • Download generated assets promptly because their URLs may expire.

Send your first request

Complete a chat request with the OpenAI-compatible format.

Handle asynchronous tasks

Add polling, timeouts, and retries.