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.mdindex 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.mdindex 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_clientembedder="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```pythondiff --cc hyperextract/utils/client.pyindex 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",),}