Skip to content

Model Selection ​

Different key formats and groups have different available model lists. Before using a model, query the model list with a key that matches the API format you plan to use.

How to Check Available Models ​

Use the model list endpoint to query available models. Anthropic-format keys should use the Anthropic request format, while OpenAI-compatible keys should use the OpenAI request format.

Match the key format

Do not mix key formats. Use the Anthropic example for Claude Code / Anthropic-format keys. Use the OpenAI example for OpenAI-compatible tools such as Codex CLI, Codex Desktop, and OpenCode.

Anthropic Format ​

bash
curl https://ai.hctopup.com/v1/models \
  -H "x-api-key: YOUR_ANTHROPIC_FORMAT_KEY" \
  -H "anthropic-version: 2023-06-01"

OpenAI-Compatible Format ​

bash
curl https://ai.hctopup.com/v1/models \
  -H "Authorization: Bearer YOUR_OPENAI_FORMAT_KEY"

The model names returned by the API are the models available to the current key. When configuring a tool, copy an existing model name from the returned list exactly.

Important Notes ​

Notes

  • Do not invent custom model names. Manually combining or changing model names will cause requests to fail.
  • Do not choose models outside your available range, or calls will not work.
  • Anthropic-format keys and OpenAI-compatible keys may return different model lists. Always use the actual API response as the source of truth.

FAQ ​

If you see errors such as “model does not exist” or “no permission to access this model”, please:

  1. Query the model list again with the matching API format.
  2. Verify that the model name configured in your tool is spelled correctly.
  3. Confirm that the group assigned to the current token supports the model.

Next Steps ​