Integration recipes

Use Black Eagle AI with OpenAI-compatible tools.

Most developer tools only need three values: API key, base URL and model id. Use these recipes to test Chinese model access before changing application code.

Shared settings

base_url: https://api.blackeaglecambodia.com/v1

model: start with deepseek-v4-flash

Legacy aliases deepseek-chat and deepseek-reasoner retire on July 24, 2026.

Billing and fit FAQ

Create API account

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.

If your real blocker is multi-provider routing, shared aliases or usage visibility, use the focused LiteLLM Chinese model routing guide before changing anything bigger in your stack.

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.

Provider

OpenAI Compatible or Custom Provider

Base URL

https://api.blackeaglecambodia.com/v1

Model

deepseek-v4-flash first, then requested models

8. Debug checklist

  1. Run a raw /chat/completions request before using a framework.
  2. Confirm the final request host is api.blackeaglecambodia.com, not api.openai.com.
  3. Keep model ids explicit; do not let a framework rewrite them silently.
  4. Test streaming, tools, structured output and media endpoints separately.
  5. 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.