PublishedGuidanceLAST REVIEWED · 30 AUG 2026
OpenAI → MC-1
Migrate incrementally from openai → mc-1 while preserving working behavior and attribution.
What changes
Keep the existing client behavior stable first. Introduce the MC-1 base URL, logical model, and server-side credential, then add control-plane constraints only after compatibility passes.
Feature mapping
- Keep the OpenAI SDK; change baseURL to MC1_BASE_URL.
- Replace a provider model with colomboai/mc-1, or keep an eligible explicit model.
- Validate Responses, Chat Completions, streaming, tools, and structured output separately.
Migration sequence
- Inventory endpoints, models, streaming, tools, retries, and error handling.
- Create a scoped MC-1 project and test key.
- Run an owned non-production fixture through both paths.
- Compare outputs, tool continuation, latency, usage, and failures.
- Canary a reversible workload before broader promotion.
Compatibility example
export MC1_API_KEY="..."
export MC1_BASE_URL="https://api.colomboai.com/v1"
# Keep the client OpenAI-compatible and use model colomboai/mc-1.Source-specific caveats
- Provider-specific beta headers and unsupported fields are not translated automatically.
- Preserve the direct OpenAI path until workload acceptance passes.
Rollback
- Retain the previous route until acceptance passes.
- Do not translate unsupported provider-specific features silently.
- Record the exact client and integration versions used for validation.
Was this page helpful?