1. Test the endpoint first
Before configuring a framework, verify that your token, model id and base URL work with one small request.
curl https://api.blackeaglecambodia.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-black-eagle-token" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}'
2. OpenAI SDK
Use this when your application already uses the OpenAI Python or JavaScript client.
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-your-black-eagle-token",
base_url="https://api.blackeaglecambodia.com/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "Draft a launch checklist."}],
)
print(response.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-your-black-eagle-token",
baseURL: "https://api.blackeaglecambodia.com/v1",
});
const response = await client.chat.completions.create({
model: "deepseek-v4-flash",
messages: [{ role: "user", content: "Draft a launch checklist." }],
});
console.log(response.choices[0].message.content);
3. LiteLLM proxy
Use a custom OpenAI-compatible model route when you want LiteLLM to sit between your application and Black Eagle AI.
model_list:
- model_name: black-eagle-deepseek-v4-flash
litellm_params:
model: openai/deepseek-v4-flash
api_key: os.environ/BLACK_EAGLE_API_KEY
api_base: https://api.blackeaglecambodia.com/v1
For image or video models, do not assume chat compatibility means media endpoint compatibility. Test the exact endpoint and provider mode separately.
4. browser-use
For browser agents, start with text-only mode and a known chat model. Turn on vision or structured output only after the raw chat call works.
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
model="deepseek-v4-flash",
api_key="sk-your-black-eagle-token",
base_url="https://api.blackeaglecambodia.com/v1",
)
# If your model does not support vision, set the agent/browser-use
# configuration to text-only before debugging browser actions.
5. Browser Use / OpenAdapter fallback route
If your team already uses Browser Use or OpenAdapter, this guide gives the smallest useful Chinese-model test path without changing the rest of your workflow.
Open the narrow fallback guide: Browser Use and OpenAdapter Chinese model fallback.
6. Qwen Code custom provider
When a tool supports OpenAI-compatible custom providers, keep each endpoint and model id explicit. If the same model name exists on multiple endpoints, use different display names.
If the issue is multiple custom providers, shared baseUrl, or model identity across different endpoints, use the focused Qwen Code multi-provider routing guide.
{
"$version": 3,
"env": {
"BLACK_EAGLE_API_KEY": "sk-your-black-eagle-token"
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"modelProviders": {
"openai": [
{
"id": "deepseek-v4-flash-black-eagle",
"name": "Black Eagle DeepSeek Chat",
"envKey": "BLACK_EAGLE_API_KEY",
"baseUrl": "https://api.blackeaglecambodia.com/v1"
}
]
}
}
7. Cline / OpenAI-compatible tools
For tools with a settings UI, choose the OpenAI-compatible provider and avoid stale OpenAI defaults after switching providers.
OpenAI Compatible or Custom Provider
https://api.blackeaglecambodia.com/v1
deepseek-v4-flash first, then requested models
8. Debug checklist
- Run a raw
/chat/completionsrequest before using a framework. - Confirm the final request host is
api.blackeaglecambodia.com, notapi.openai.com. - Keep model ids explicit; do not let a framework rewrite them silently.
- Test streaming, tools, structured output and media endpoints separately.
- For Qwen, Kimi, GLM, Kling or Seedance access, check the model catalog and submit a defined workload via the request template.
Use the smallest possible test first. If it works, then top up credits and run a workload-sized evaluation.
Need a framework-specific example? Start with the Hermes Agent + DeepSeek V4 guide for the current HTTP 400 / HTTP 307 class of DeepSeek issues.
If Hermes Desktop or Hermes Agent is stuck on custom OpenAI-compatible provider setup, use the Hermes custom endpoint guide for key_env, readiness, runtime-check and model-discovery drift.
For Qwen Code custom-provider and baseUrl persistence issues, use the Qwen Code OpenAI-compatible guide.
For Qwen Code multi-provider routing, shared baseUrl, model identity and same-model different-endpoint cases, use the Qwen Code multi-provider routing guide.
If your blocker is not configuration but the disappearance of the free tier or a plan that is too large, use the Qwen Code after free tier guide.
For DeepSeek or MiMo tool-call loops that fail after streaming reasoning, use the DeepSeek reasoning_content guide.
For DashScope responses or audio compatibility checks, use the DashScope responses and audio guide to split native provider behavior from OpenAI-compatible relay behavior.
If the blocker is not framework setup but China phone verification or local payment, use the no-China-phone Chinese AI API guide before sending a starter-trial link.