Skip to content

Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.

Merge pull request #192 from heydryft/feat/runcrate-provider

Yifan Fengc85fc1386fa0
diff --cc docs/en/concepts/provider-system.md
index 5cadcf7,0cb094a..dc52342
--- a/docs/en/concepts/provider-system.md
+++ b/docs/en/concepts/provider-system.md
@@@ -16,8 -16,8 +16,9 @@@ Hyper-Extract supports these ways to co
| **DeepSeek** | deepseek-v4-flash / deepseek-v4-pro | ✅ | ✅ | OpenAI-compatible. V4 models default to "thinking" mode, which Hyper-Extract auto-disables (`extra_body`) so structured extraction works. LLM only — no embeddings API. Keys: `DEEPSEEK_API_KEY` |
| **OrcaRouter** | `orcarouter/auto`, `openai/gpt-4o-mini`, `anthropic/claude-haiku-4-5`, `deepseek/...`, `gemini/...` | ✅ | ✅ | OpenAI-compatible gateway routing 150+ models from OpenAI, Anthropic, Google, DeepSeek, Qwen, MiniMax, xAI behind one endpoint and key. Keys: `ORCAROUTER_API_KEY` |
| **Cheaper Inference** | gpt-5.4-mini | ✅ | ✅ | OpenAI-compatible gateway. One key gives access to models from several labs. LLM only — no embeddings API (pair with an OpenAI-compatible embedder). Keys: `CHEAPER_INFERENCE_API_KEY` |
+| **API Route** | gpt-6.1-sol | ✅ | ✅ | OpenAI-compatible LLM preset. Configure an embedding provider separately. Key: `API_ROUTE_API_KEY`. [Setup guide](../python/guides/provider-configuration.md#api-route) |
| **Atlas Cloud** | `deepseek-ai/deepseek-v4-flash`, `deepseek-ai/deepseek-v4-pro`, `moonshotai/kimi-k3`, `qwen/qwen3.5-plus`, `openai/gpt-5.5`, `anthropic/claude-sonnet-4.6` | ✅ | ✅ | OpenAI-compatible gateway serving DeepSeek, Z.ai, Moonshot, Qwen, MiniMax, OpenAI, Anthropic and Google models under vendor-prefixed ids. LLM only — no embeddings API. `glm-5.x` models reject the forced `tool_choice` structured extraction uses; pick another model. Keys: `ATLASCLOUD_API_KEY` |
+ | **Runcrate** | `deepseek-ai/DeepSeek-V4.1-Flash`, `openai/gpt-oss-120b` | ✅ | ✅ | OpenAI-compatible API for open models under vendor-prefixed ids. Also serves embeddings (`BAAI/bge-m3`, 1024 dims), so one key covers the LLM and the embedder. Open models are free with your GitHub account. `zai-org/GLM-5.x` returned an empty graph in testing; pick another model. Keys: `RUNCRATE_API_KEY` |
| **Alibaba Bailian** | qwen-plus / qwen-turbo / qwen3.6-plus / deepseek-r1 | ✅ | ✅ | Works out of the box |
| **Alibaba Bailian** | qwen-max / deepseek-v3 | ❌ | ❌ | Only `json_object`; not compatible with function-calling structured output |
diff --cc docs/en/python/guides/provider-configuration.md
index e5ef8bd,6b95960..6db7480
--- a/docs/en/python/guides/provider-configuration.md
+++ b/docs/en/python/guides/provider-configuration.md
@@@ -78,34 -78,23 +78,48 @@@ llm, emb = create_client
embedder="openai:text-embedding-3-small",
)
# Or override the model: create_client(llm="atlascloud:moonshotai/kimi-k3", ...)
- # Avoid glm-5.x here: it rejects the forced tool_choice that extraction uses.
+ ```
+
+ ### Runcrate
+
+ ```python
+ from hyperextract import create_client
+
+ # Runcrate is an OpenAI-compatible API for open models with vendor-prefixed ids.
+ # It also serves embeddings, so one key covers the LLM and the embedder.
+ # Key: RUNCRATE_API_KEY.
+ llm, emb = create_client(
+ llm="runcrate", # default model: deepseek-ai/DeepSeek-V4.1-Flash
+ embedder="runcrate", # default embedder: BAAI/bge-m3
+ )
+ # Or override the model: create_client(llm="runcrate:openai/gpt-oss-120b", ...)
```
+### API Route
+
+Set `API_ROUTE_API_KEY` to a key from [API Route](https://www.api-route.com).
+The preset uses `https://global.api-route.com/v1` and defaults to `gpt-6.1-sol`.
+Configure an embedding provider separately:
+
+```python
+from hyperextract import create_client
+
+# Keys: API_ROUTE_API_KEY for the LLM, OPENAI_API_KEY for embeddings.
+llm, emb = create_client(
+ llm="api-route", # override with "api-route:<model-id>"
+ embedder="openai:text-embedding-3-small",
+)
+```
+
+Use a model ID from the [model catalog](https://www.api-route.com/pricing) or
+the authenticated `GET https://global.api-route.com/v1/models` response.
+For CLI configuration:
+
+```bash
+he config llm -p api-route -m gpt-6.1-sol
+he config embedder -p openai -m text-embedding-3-small
+```
+
### Cheaper Inference
```python
diff --cc hyperextract/utils/client.py
index e22c4b9,351a853..336e478
--- a/hyperextract/utils/client.py
+++ b/hyperextract/utils/client.py
@@@ -138,8 -141,8 +146,9 @@@ PROVIDER_API_KEY_ENV: dict[str, tuple[s
"deepseek": ("DEEPSEEK_API_KEY",),
"orcarouter": ("ORCAROUTER_API_KEY",),
"cheaperinference": ("CHEAPER_INFERENCE_API_KEY",),
+ "api-route": ("API_ROUTE_API_KEY",),
"atlascloud": ("ATLASCLOUD_API_KEY",),
+ "runcrate": ("RUNCRATE_API_KEY",),
}