API overview
DINGJIAI API families, public entries, authentication, and model selection.
Choose the API family or entry before choosing a model
DINGJIAI exposes public API families and native wire entries for OpenAI Chat Completions, OpenAI Responses, Images Generations, Anthropic Messages, and Gemini GenerateContent. Use the path, headers, and request body for the entry you choose. The gateway does not automatically translate one API family or protocol into another.
Public API families and entries
| API family or entry | Public path | Authentication |
|---|---|---|
| OpenAI Chat Completions | POST /v1/chat/completions or POST /chat/completions | Authorization: Bearer <DINGJIAI user API key> |
| OpenAI Responses | POST /v1/responses | Authorization: Bearer <DINGJIAI user API key> |
| Codex Search capability | POST /v1/alpha/search | Authorization: Bearer <DINGJIAI user API key> |
| Images API · Generations | POST /v1/images/generations | Authorization: Bearer <DINGJIAI user API key> |
| Anthropic Messages | POST /v1/messages or POST /anthropic/v1/messages | x-api-key: <DINGJIAI user API key> |
| Anthropic Messages · Count Tokens | POST /v1/messages/count_tokens or POST /anthropic/v1/messages/count_tokens | x-api-key: <DINGJIAI user API key> |
| Gemini GenerateContent | POST /v1beta/models/{model}:generateContent | x-goog-api-key: <DINGJIAI user API key> |
| Gemini StreamGenerateContent | POST /v1beta/models/{model}:streamGenerateContent | x-goog-api-key: <DINGJIAI user API key> |
Codex Search is a capability used in the Responses workflow, not a separate top-level API family or billing system. Count Tokens is an operation under Anthropic Messages. Images Edits is currently a private signed-in web operation at POST /api/img/edits; /v1/images/edits is not a public API entry.
Start with the matching protocol
- For existing OpenAI-compatible clients, start with Chat Completions.
- For new OpenAI projects and Codex-like tools, read Responses.
- For Base URL and header choices across all public entries, see Base URL and authentication.
- Codex may use Search automatically during a Responses workflow; it does not require another credential or a separate charge.
Anthropic and Gemini requests must remain in their native API family. The Base URL and authentication guide lists their current paths and headers; a model list from one API entry does not prove that the same public model id is available on another entry.
Model selection and billing
Use a public model id that the platform or administrator has published for the API family or internal entry you are calling. The same id is not automatically available across entries, and it does not represent the full capability matrix of an upstream model.
Before a model call, the account's available balance must be greater than zero. DINGJIAI settles the call using the matching API family's usage rules and records usage, billing, and balance activity in the console.
Last updated on