Skip to content

add Apertis model provider documentation - #2098

Merged
Naomi Pentrel (npentrel) merged 4 commits into
langchain-ai:mainfrom
theQuert:docs/add-apertis-provider
Aug 6, 2026
Merged

add Apertis model provider documentation#2098
Naomi Pentrel (npentrel) merged 4 commits into
langchain-ai:mainfrom
theQuert:docs/add-apertis-provider

Conversation

@theQuert

Copy link
Copy Markdown
Contributor

Summary

Add documentation for Apertis, a third-party model provider with OpenAI-compatible API that provides access to multiple LLMs.

Changes

  • Create new provider page at providers/apertis.mdx
  • Add Apertis card to all_providers.mdx
  • Add Apertis accordion example to chat/index.mdx

Provider Details

  • API Type: OpenAI-compatible (uses langchain-openai with custom base_url)
  • Base URL: https://api.apertis.ai/v1
  • Integrations: Chat, LLM, Embeddings
  • Features: Tool calling, Structured output, Multimodal, Streaming

Test plan

  • Verify provider page renders correctly at /oss/python/integrations/providers/apertis
  • Verify Apertis card appears in All Providers list
  • Verify Apertis accordion appears in Chat index page

@github-actions github-actions Bot added langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects external User is not a member of langchain-ai labels Jan 6, 2026
@github-actions

github-actions Bot commented Jan 6, 2026

Copy link
Copy Markdown
Contributor

❌ Import check failed

This PR contains imports from langchain_core that should be imported from langchain instead.

Detailed issues
Analyzing diff for import issues...
 Found 4 import issues:

File: src/oss/python/integrations/providers/apertis.mdx
Line: 50
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage
Suggested: from langchain.messages import HumanMessage
--------------------------------------------------------------------------------
File: src/oss/python/integrations/providers/apertis.mdx
Line: 107
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage, ToolMessage
Suggested: from langchain.messages import HumanMessage, ToolMessage
--------------------------------------------------------------------------------
File: src/oss/python/integrations/providers/apertis.mdx
Line: 108
Issue: Import from langchain.tools instead of langchain_core.tools
Current:   from langchain_core.tools import tool
Suggested: from langchain.tools import tool
--------------------------------------------------------------------------------
File: src/oss/python/integrations/providers/apertis.mdx
Line: 147
Issue: Import from langchain.messages instead of langchain_core.messages
Current:   from langchain_core.messages import HumanMessage
Suggested: from langchain.messages import HumanMessage
--------------------------------------------------------------------------------

 Found 4 import issues that need to be fixed.

Why this is a problem

The langchain package re-exports many modules and classes from langchain_core. When possible, imports should use langchain instead of langchain_core for:

  • Better user experience (single import source)
  • Consistency across documentation
  • Reduced cognitive load for users

How to fix

Replace the imports as suggested above. For example:

  • from langchain_core.messages import HumanMessage
  • from langchain.messages import HumanMessage

🤖 Automated check

This check is based on the latest analysis of langchain re-exports from langchain_core.

@theQuert
Quert (theQuert) force-pushed the docs/add-apertis-provider branch from d27ba50 to dac923d Compare January 6, 2026 06:26
Comment on lines +76 to +91
<Accordion title="Example: Apertis">
[Apertis](https://apertis.ai) provides an OpenAI-compatible API with access to multiple LLMs. Sign up for an account and obtain an API key.

```python
from langchain_openai import ChatOpenAI

model = ChatOpenAI(
model="gpt-5.2-chat", # Also: gpt-5.1-chat, gemini-3-pro-preview, claude-opus-4-5-20251101, etc.
api_key="APERTIS_API_KEY",
base_url="https://api.apertis.ai/v1",
)
```

Refer to the [Apertis documentation](https://apertis.ai) for available models and features.
</Accordion>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think we'd prefer to remove this for now, as there are many nuances with regard to additions/abuses of the OpenAI spec to include non-unified/standard features

@mdrxy Mason Daugherty (mdrxy) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good after the requested change

@mdrxy Mason Daugherty (mdrxy) added the integration For docs updates for LangChain integrations label Jan 24, 2026
@theQuert

Copy link
Copy Markdown
Contributor Author

Codex (@codex) review

@theQuert
Quert (theQuert) force-pushed the docs/add-apertis-provider branch from 0b8188d to 4746d8c Compare August 2, 2026 14:27
@langchain-oss-automated-triage

Copy link
Copy Markdown

Thanks for contributing a new integration docs page, Quert (@theQuert)!

As of July 28, 2026, we have changed how we accept external integrations submissions. Please review the new integration submission process for more information.

We receive a large number of PRs and review them as quickly as we can. Please bear with us as we work through the queue.

If you have already tagged a maintainer on this PR, do not tag them again.

@theQuert

Copy link
Copy Markdown
Contributor Author

Codex (@codex) review

Latest head: 4746d8c (rebased onto current upstream main).

Resolved the provider-index conflict and narrowed the Apertis page to a catalog-neutral ChatOpenAI setup: the public model-list probe requires an API key (401), so the docs now direct users to their authenticated /v1/models result instead of claiming fixed model IDs or unsupported features.

Verified: uv run scripts/check_pr_imports.py, ruff format --diff, ruff check --diff, ty check, codespell src, and markdownlint for the provider page/index. No live model request was made because no API key was used.

@theQuert
Quert (theQuert) force-pushed the docs/add-apertis-provider branch 2 times, most recently from 894fefe to 575193c Compare August 3, 2026 07:11
Quert (theQuert) and others added 4 commits August 6, 2026 13:38
No dedicated LangChain package (uses ChatOpenAI with base_url). Drop the
hosted provider page and Accordion; surface via partner docs instead.

Co-authored-by: Cursor <cursoragent@cursor.com>

@npentrel Naomi Pentrel (npentrel) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi there, we've made a change to the effect that we no longer add external integration docs to our docs and instead link out to your docs directly from the overview table. I've made those changes here and will merge the PR once tests pass. Thanks!

@npentrel
Naomi Pentrel (npentrel) merged commit 5aa7b5e into langchain-ai:main Aug 6, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

external User is not a member of langchain-ai integration For docs updates for LangChain integrations langchain For docs changes to LangChain oss python For content related to the Python version of LangChain projects

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants