1Stack AI Mission Control API Reference

The 1Stack AI Mission Control API provides OpenAI-compatible and Anthropic-compatible interfaces for LLM inference, embeddings, reranking, and audio processing. All endpoints use standard HTTP methods and return JSON (except audio/speech which returns binary audio).

Base URL: https://taas.cloudsigma.com/v1

Codex native base URL: https://taas.cloudsigma.com/v1/codex

1Stack AI Mission Control now also exposes a native Codex-compatible endpoint for clients such as Codex ACP and other Codex-native integrations. Use the standard /v1 OpenAI-compatible base for normal SDK traffic, and the native Codex base when a client expects Codex-specific request semantics. Anthropic SDK clients are served natively via POST /v1/messages on the same base URL.

Authentication

Authenticate every request with a 1Stack AI Mission Control Bearer token in the Authorization header. Tokens are prefixed with taas_ and are scoped per team or project.

Authorization Header:
Authorization: Bearer taas_xxxxxxxxxxxxxxxx

Generate API tokens from Settings → API Tokens in the 1Stack AI Mission Control console. Keep tokens secret — they grant full access to your account's quota.

Session affinity & request observability

If you want repeated requests to stay on the same routed session, you can send a stable session identifier. This improves continuation reliability and makes request-level debugging easier in the 1Stack AI Mission Control console.

InputWhere to send itNotes
X-Session-IdHTTP headerHighest precedence. Best option when you control headers.
metadata.session_idJSON body metadataStable explicit session id for OpenAI-compatible request bodies.
metadata.sticky_keyJSON body metadataCompatibility fallback, especially useful for Anthropic-style continuation flows.

Precedence is X-Session-Id → metadata.session_id → metadata.sticky_key. If none are supplied, 1Stack AI Mission Control can still infer continuity heuristically, but explicit IDs are more predictable.

Error Handling

Application errors use code - human-readable explanation. For automation, read error.code; for a user-facing message, prefer error.human_message. The complete formatted string remains in error.message.

{"error":{"code":"billing_limit_reached","type":"permission_error","message":"billing_limit_reached - Out of funds. Contact your billing administrator.","human_message":"Out of funds. Contact your billing administrator."}}

A 403 billing_limit_reached means the effective payer needs attention. The payer may be a project, organisation billing user, delegated user, or yourself. A budget is a spending setting, not wallet funds. Changing a valid API key will not fix an empty payer wallet.

HTTP status, Retry-After, and structured retry metadata remain authoritative. Do not automate by matching English text. Handle unknown codes safely, and do not automatically repeat operations with side effects. Streams may begin with HTTP 200 and later emit an error event; treat partial output as incomplete.

Legacy portal responses retain their error or detail fields and add top-level code, message, and human_message. Provider-specific and numeric JSON-RPC codes keep their original identity. Split a formatted message at the first exact - separator only when its prefix is a valid code.

Machine-readable error code reference · Download reference JSON

Full platform error code reference

These are statically declared platform codes. Dynamic provider codes may also occur. Use the actual response status for codes without one fixed HTTP status.

CodeMeaningSuggested action
account_statusAccount status.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
alias_redirect_conflictAlias redirect conflict.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
all_providers_exhaustedAll providers exhausted.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
anthropic_terminal_finalization_failedAnthropic terminal finalization failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
async_completion_too_largeAsync completion too large.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
atomic_canary_binding_missingAtomic canary binding missing.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
atomic_canary_forbiddenAtomic canary forbidden.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
atomic_canary_identity_missingAtomic canary identity missing.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
atomic_canary_lane_mismatchAtomic canary lane mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
atomic_canary_manual_reviewA dispatched atomic paid canary has an unconfirmed settlement.Do not repeat the operation or release its hold. Give support the request ID for operator review and reconciliation.
atomic_canary_refusedAtomic canary refused.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
atomic_canary_unknownA dispatched atomic paid canary has an unknown supplier outcome.Do not repeat the operation or release its hold. Give support the request ID to reconcile the original supplier outcome and settlement.
auth_context_deniedAuth context denied.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
auth_issueAuth issue.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
auth_unavailableAuth unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
authenticationAuthentication.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
authentication_requiredAuthentication required.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
autorouter_no_candidateAutorouter no candidate.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
autorouter_unavailableAutorouter unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
backend_errorBackend error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
backup_chain_exhaustedBackup chain exhausted.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
billing_limit_reachedThe effective payer cannot fund or authorize this request.Check the effective payer, available funds, spending limits and billing configuration. Fund the payer or contact its billing administrator; retry only after correction.
billing_proof_unavailableBilling proof unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
billing_unavailableBilling unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
bridge_operation_failedBridge operation failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
bridge_timeoutBridge timeout.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
budget_alert_history_unavailableBudget alert history unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
budget_exceededThe API key spending or usage budget was reached.Review the key budget and usage. Increase an authorized limit or wait for the applicable reset; adding wallet funds alone may not resolve a budget cap.
byok_budget_unknownByok budget unknown.Review the effective payer, balance, spending limits and payment configuration. Contact the billing administrator before retrying.
byok_mode_unavailableByok mode unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
capability_deniedCapability denied.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
capability_unsupportedCapability unsupported.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
capacity_exceededCapacity exceeded.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
claim_expiredClaim expired.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
claim_mismatchClaim mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_cli_result_errorClaude cli result error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_code_async_tool_result_forward_failedClaude code async tool result forward failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_code_incomplete_streamClaude code incomplete stream.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_code_missing_endpointClaude code missing endpoint.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_code_node_errorClaude code node error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
claude_code_tool_result_forward_failedClaude code tool result forward failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
client_secret_collisionClient secret collision.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
client_secret_limitClient secret limit.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
client_secret_origin_mismatchClient secret origin mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
client_secret_principal_mismatchClient secret principal mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
client_secret_scope_mismatchClient secret scope mismatch.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
codex_backend_errorCodex backend error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
codex_errorCodex error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
codex_org_context_requiredCodex org context required.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
codex_org_lane_disabledCodex org lane disabled.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
codex_token_errorCodex token error.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
collection_errorCollection error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
configuration_errorConfiguration error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
conflictConflict.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
context_lengthContext length.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
context_length_exceededContext length exceeded.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
context_length_exceeded_orchestrationContext length exceeded orchestration.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
corp_key_exceptionCorp key exception.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
csrf_failedCsrf failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
csrf_rejectedThe browser request failed the same-origin security check.Reload the page on the correct portal domain, sign in again, and repeat the action.
current_quota_unavailableCurrent quota unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
delivery_lease_unknownDelivery lease unknown.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
document_conversion_errorDocument conversion error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
document_conversion_operation_unavailableDocument conversion operation unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
document_conversion_provider_policy_invalidDocument conversion provider policy invalid.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
document_conversion_settlement_unavailableDocument conversion settlement unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
edge_errorThe edge could not reach the application service.Retry transient failures with bounded exponential backoff. If persistent, contact support.
email_not_verifiedEmail not verified.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
email_takenEmail taken.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
empty_responseEmpty response.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
empty_streamEmpty stream.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
error_catalog_unavailableError catalog unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
exceptionException.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
expired_api_keyExpired api key.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
expired_client_secretExpired client secret.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
fake_adapter_forbiddenFake adapter forbidden.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
forbiddenForbidden.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
free_token_grant_create_failedFree token grant create failed.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
free_token_grant_update_failedFree token grant update failed.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
from_address_domain_mismatchFrom address domain mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
idempotency_conflictIdempotency conflict.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
identity_cycleIdentity cycle.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
identity_execution_capacityThe selected execution identity has no available capacity.Wait for current work to finish. Respect Retry-After and retryable/reallocate metadata; do not switch identities when reallocation is forbidden.
internal_errorInternal error.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
invalid_api_keyInvalid api key.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
invalid_argumentsInvalid arguments.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_backend_responseInvalid backend response.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_client_secretInvalid client secret.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_credentialsInvalid credentials.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
invalid_document_inputInvalid document input.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_domainInvalid domain.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_emailInvalid email.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_event_typeInvalid event type.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_expires_afterInvalid expires after.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_from_addressInvalid from address.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_idempotency_keyInvalid idempotency key.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_image_countInvalid image count.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_image_dimensionsInvalid image dimensions.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_inputInvalid input.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_jsonInvalid json.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_lane_pinInvalid lane pin.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_ocr_inputInvalid ocr input.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_providerInvalid provider.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_provider_change_requestInvalid provider change request.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_provider_sdpInvalid provider sdp.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_publication_requestInvalid publication request.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_realtime_modeInvalid realtime mode.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_requestInvalid request.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_schema_versionInvalid schema version.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_sdpInvalid sdp.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_sessionInvalid session.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
invalid_terminalInvalid terminal.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
invalid_tokenInvalid token.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
invalid_upstream_call_idInvalid upstream call id.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
invalid_workload_attributionInvalid workload attribution.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
json_decode_errorJson decode error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
last_error_no_contentLast error no content.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
lease_expired_or_unknownLease expired or unknown.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
lease_mismatchLease mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
live_metric_divergence_unavailableLive metric divergence unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
live_metric_health_unavailableLive metric health unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
materializer_unavailableMaterializer unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
max_delivery_attempts_exceededMax delivery attempts exceeded.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
max_hops_exceededMax hops exceeded.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
method_not_allowedMethod not allowed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_api_keyMissing api key.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
missing_client_secretMissing client secret.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_emailMissing email.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_eventsMissing events.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_fieldsMissing fields.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_modelMissing model.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_nodeMissing node.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_promptMissing prompt.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_session_keyMissing session key.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
missing_sticky_keyMissing sticky key.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_terminalMissing terminal.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_tool_call_idMissing tool call id.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
missing_workspaceMissing workspace.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_claude_code_unauthorizedModel claude code unauthorized.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
model_does_not_support_toolsModel does not support tools.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_not_accessibleModel not accessible.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
model_not_allowedModel not allowed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_not_availableModel not available.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_not_configuredModel not configured.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_not_foundModel not found.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
model_unavailableModel unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
no_corporate_keysNo corporate keys.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
no_domainNo domain.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
no_providers_availableNo providers available.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
no_resellerNo reseller.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
non_json_provider_responseNon json provider response.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
not_foundNot found.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
not_implementedNot implemented.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
observer_unavailableObserver unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
openrouter_http_errorOpenrouter http error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
operation_in_progressOperation in progress.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
operation_too_largeOperation too large.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
operation_unknownOperation unknown.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
origin_context_unavailableOrigin context unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
origin_not_allowedOrigin not allowed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
origin_requiredOrigin required.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
payload_not_durablePayload not durable.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
payment_requiredPayment required.Review the effective payer, balance, spending limits and payment configuration. Contact the billing administrator before retrying.
permission_deniedPermission denied.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
pin_ambiguous_lanePin ambiguous lane.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
pin_forbiddenPin forbidden.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
pin_no_lanePin no lane.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
pod_drainingPod draining.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
preferred_node_unavailablePreferred node unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
pricing_provenance_unavailablePricing provenance unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
promo_grant_create_failedPromo grant create failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
promo_grant_update_failedPromo grant update failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_change_not_foundProvider change not found.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_change_status_conflictProvider change status conflict.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_check_failedProvider check failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_errorProvider error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_missing_locationProvider missing location.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_realtime_errorProvider realtime error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_redirect_forbiddenProvider redirect forbidden.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
provider_response_too_largeProvider response too large.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_route_mismatchProvider route mismatch.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
provider_timeoutProvider timeout.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
provider_unavailableProvider unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
proxy_event_ingest_disabledProxy event ingest disabled.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
publication_plan_conflictPublication plan conflict.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
publication_plan_not_foundPublication plan not found.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
rate_limit_exceededRate limit exceeded.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
rate_limit_state_unavailableRate limit state unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
raw_secret_field_rejectedRaw secret field rejected.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
realtime_call_recovery_requiredA possibly created realtime call requires recovery.Do not create a replacement call. Give support the request ID to recover or reconcile the original supplier call and its billing state.
realtime_capacity_unavailableRealtime capacity unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
realtime_keyring_malformedRealtime keyring malformed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
realtime_keyring_unavailableRealtime keyring unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
realtime_limit_exceededRealtime limit exceeded.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
realtime_service_unavailableRealtime service unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
realtime_state_unavailableRealtime state unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
realtime_transport_requiredRealtime transport required.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
relay_errorRelay error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
replacement_requiredReplacement required.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
request_exceptionRequest exception.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
request_rejectedRequest rejected.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
request_timeoutRequest timeout.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
request_too_largeRequest too large.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
requester_bridge_async_completion_drain_failedRequester bridge async completion drain failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
requester_bridge_disabledRequester bridge disabled.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
requester_bridge_required_unavailableThe required requester bridge is unavailable.Have the service administrator restore the required bridge or choose a supported workflow. Do not repeatedly retry an unsupported route.
responses_provider_unavailableResponses provider unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
responses_terminal_finalization_failedResponses terminal finalization failed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
responses_terminal_not_completedResponses terminal not completed.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
result_too_largeResult too large.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
retryableRetryable.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
secondary_only_evidence_cannot_stageSecondary only evidence cannot stage.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
server_errorServer error.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
service_unavailableService unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
session_collisionSession collision.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
session_limitSession limit.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
session_too_largeSession too large.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
settlement_pendingDocument conversion succeeded and its durable zero-cost settlement is pending.Keep the original request body and Idempotency-Key when checking or recovering the result. Do not use a new key to repeat conversion; contact support if settlement remains pending.
sovereign_route_unavailableSovereign route unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
sovereign_route_validation_unavailableSovereign route validation unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
sse_bridge_capacity_exhaustedSse bridge capacity exhausted.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
sso_onlySso only.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
stale_reconciliation_actionStale reconciliation action.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
stream_dropStream drop.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
stream_droppedStream dropped.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
stream_errorThe response stream could not be completed.Treat output as incomplete. Reconcile side effects before retrying non-idempotent work.
stream_exceptionStream exception.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
stream_interruptedThe response stream stopped before completion.Treat output as incomplete. Reconcile side effects before retrying non-idempotent work.
streaming_settlement_buffer_exceededThe private response buffer exceeded its settlement limit.Have support reconcile the original operation before retrying; then reduce the response size or correct the authorized buffer configuration.
streaming_settlement_cancelledExact streaming settlement was cancelled.Cancellation does not prove the supplier did no work. Do not repeat the operation until support confirms its execution and billing status.
streaming_settlement_failedExact streaming settlement did not complete.Treat the operation as unconfirmed. Do not repeat it until support reconciles supplier execution and billing using the request ID.
streaming_settlement_requiredStreaming settlement required.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
strict_preferred_runtime_node_unavailableStrict preferred runtime node unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
supplier_limitSupplier limit.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
supplier_price_unresolvedThe required supplier pricing authority could not be confirmed.Have an administrator restore the exact supplier pricing configuration and check whether this request already executed before retrying. This code may occur before or after supplier execution.
supplier_settlement_failedUsage settlement could not be confirmed after possible supplier execution.Do not repeat the operation. Give support the request ID to reconcile supplier execution, usage and any wallet debit before retrying.
supplier_settlement_unavailableUsage settlement is unavailable.Do not automatically repeat the request. Have support confirm the original operation and billing status before authorizing a retry.
timeoutTimeout.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
too_many_eventsToo many events.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
tos_not_acceptedTos not accepted.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
transcription_provider_unavailableTranscription provider unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
unauthenticatedUnauthenticated.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
unauthorizedUnauthorized.Check the named authentication or credential condition. Sign in again or have the account administrator correct it; do not loop retries with the same rejected credentials.
unresolved_image_dimensionsUnresolved image dimensions.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsafe_realtime_upstreamUnsafe realtime upstream.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
unsupported_auto_modeUnsupported auto mode.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_autorouter_algorithmUnsupported autorouter algorithm.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_document_typeUnsupported document type.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_image_modelUnsupported image model.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_media_typeUnsupported media type.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_ocr_adapterUnsupported ocr adapter.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_parameterUnsupported parameter.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_realtime_eventUnsupported realtime event.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
unsupported_realtime_modelUnsupported realtime model.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
upstream_closed_without_sessionUpstream closed without session.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
upstream_errorUpstream error.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
upstream_failedUpstream failed.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
upstream_invalid_responseUpstream invalid response.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
upstream_timeoutUpstream timeout.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
upstream_unavailableUpstream unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
user_not_foundUser not found.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
validation_errorValidation error.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
weak_passwordWeak password.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.
webchat_exchange_unavailableWebchat exchange unavailable.Respect Retry-After and any structured retryable metadata. Use bounded exponential backoff only when retry is appropriate; contact support if persistent.
webchat_key_scopeWebchat key scope.Check the explanation and required account, model, project or organisation policy. Correct the configuration or request the necessary access before retrying.
webrtc_broker_not_enabledWebrtc broker not enabled.Read human_message and any param/detail fields, correct the request or resource state, and retry only after the condition changes.

GET List Models

/v1/models

Returns the list of all models available to your account. Each model object includes its identifier, type, and owner. Use the id field as the model parameter in inference requests.

Response Fields
FieldTypeDescription
idstringModel identifier to use in API calls (e.g. claude-sonnet-4)
objectstringAlways "model"
owned_bystringProvider name (e.g. anthropic, openai)
# List available models
curl https://taas.cloudsigma.com/v1/models \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx"
import requests

response = requests.get(
    "https://taas.cloudsigma.com/v1/models",
    headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"}
)
models = response.json()
for m in models:
    print(m["id"])  # e.g. "claude-sonnet-4"
const response = await fetch(
  "https://taas.cloudsigma.com/v1/models",
  {
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"
    }
  }
);
const models = await response.json();
models.forEach(m => console.log(m.id));
Response · 200
[
  {
    "id": "claude-sonnet-4",
    "object": "model",
    "owned_by": "anthropic"
  },
  {
    "id": "gpt-4o",
    "object": "model",
    "owned_by": "openai"
  },
  {
    "id": "minimax-m2",
    "object": "model",
    "owned_by": "minimax"
  }
]

POST Chat Completions

/v1/chat/completions

Generate a chat completion response from a model. Supports streaming via Server-Sent Events. Compatible with OpenAI's chat/completions API — existing OpenAI clients work by changing the base URL and API key.

Request Body
FieldTypeDescription
model requiredstringModel ID from /v1/models (e.g. claude-sonnet-4)
messages requiredarrayArray of {role, content} objects. Roles: system, user, assistant
metadata.session_idstringOptional explicit session id for continuity and easier per-request tracing.
metadata.sticky_keystringOptional sticky routing key. Used after X-Session-Id and metadata.session_id.
streambooleanStream tokens via SSE (default: false)
temperaturenumberSampling temperature 0–2 (default: 1.0). Higher = more creative
max_tokensintegerMaximum tokens to generate
top_pnumberNucleus sampling probability 0–1 (default: 1.0)
Response Fields
FieldTypeDescription
choices[].message.rolestringAlways "assistant"
choices[].message.contentstringGenerated text
usage.prompt_tokensintegerTokens in the input messages
usage.completion_tokensintegerTokens generated
usage.total_tokensintegerSum of prompt + completion tokens
# Chat completion with explicit session continuity
curl -X POST https://taas.cloudsigma.com/v1/chat/completions \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "X-Session-Id: user-42-chat-a" \
  -d '{
    "model": "claude-sonnet-4",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Explain quantum entanglement."}
    ],
    "metadata": {
      "session_id": "user-42-chat-a"
    },
    "temperature": 0.7,
    "max_tokens": 512
  }'
import requests

response = requests.post(
    "https://taas.cloudsigma.com/v1/chat/completions",
    headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"},
    json={
        "model": "claude-sonnet-4",
        "messages": [
            {"role": "system", "content": "You are a helpful assistant."},
            {"role": "user", "content": "Explain quantum entanglement."}
        ],
        "temperature": 0.7,
        "max_tokens": 512
    }
)
result = response.json()
print(result["choices"][0]["message"]["content"])
const response = await fetch(
  "https://taas.cloudsigma.com/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "claude-sonnet-4",
      messages: [
        { role: "system", content: "You are a helpful assistant." },
        { role: "user", content: "Explain quantum entanglement." }
      ],
      temperature: 0.7,
      max_tokens: 512,
    }),
  }
);
const data = await response.json();
console.log(data.choices[0].message.content);
Response · 200
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "claude-sonnet-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum entanglement is a phenomenon..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 142,
    "total_tokens": 170
  }
}

POST Messages (Anthropic-compatible)

/v1/messages

Anthropic Messages API-compatible endpoint, running fully in parallel with /v1/chat/completions. Point the Anthropic SDK's base_url at 1Stack AI Mission Control and authenticate with your 1Stack AI Mission Control API key (sent as x-api-key or a Bearer token — both are accepted). Supports system prompts, tools with tool_use/tool_result blocks, images, and streaming with the full Anthropic SSE event sequence. Works with every model in the catalogue, including auto: requests to OpenAI-backed models are converted transparently in both directions, while Anthropic-backed models pass through natively. POST /v1/messages/count_tokens is also available.

curl -X POST https://taas.cloudsigma.com/v1/messages \
  -H "x-api-key: $TAAS_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "auto", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'
# Python (Anthropic SDK) — change only base_url and api_key
from anthropic import Anthropic
client = Anthropic(base_url="https://taas.cloudsigma.com", api_key=TAAS_API_KEY)
msg = client.messages.create(model="auto", max_tokens=1024,
                             messages=[{"role": "user", "content": "Hello"}])

POST Codex native responses

/v1/codex/responses

Native Codex-compatible passthrough endpoint for Codex-specific clients such as Codex ACP. Requests sent here are routed to Codex OAuth tokens only and are forwarded without the Chat Completions → Codex transformation used by the OpenAI-compatible proxy path.

Important: this endpoint expects Codex-native request semantics. In particular, input must be a list and stream must be set to true.

FieldTypeDescription
model requiredstringCodex-capable model id (for example gpt-5.4)
instructionsstringOptional system/instructions text
input requiredarrayNative Codex input message array
stream requiredbooleanMust be true for native Codex requests
storebooleanPassed through as provided

Recommended for harnesses and agent runtimes that already speak Codex-native protocol. For ordinary OpenAI SDK traffic, keep using /v1/chat/completions and the standard OpenAI-compatible base URL.

curl -X POST https://taas.cloudsigma.com/v1/codex/responses \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "store": false,
    "stream": true,
    "instructions": "Reply with exactly OK",
    "input": [
      {"role": "user", "content": "Reply with exactly OK"}
    ]
  }'

POST Embeddings

/v1/embeddings

Generate vector embeddings for one or more text inputs. Use embeddings for semantic search, similarity comparison, clustering, and retrieval-augmented generation (RAG).

Request Body
FieldTypeDescription
model requiredstringEmbedding model ID (e.g. bge-m3)
input requiredstring or arrayText string or array of strings to embed. Max 2048 tokens per string.
Response Fields
FieldTypeDescription
data[].embeddingarrayDense float vector representing the input text
data[].indexintegerIndex of the input string this embedding corresponds to
usage.prompt_tokensintegerTotal tokens processed
usage.total_tokensintegerSame as prompt_tokens for embeddings
# Generate embeddings
curl -X POST https://taas.cloudsigma.com/v1/embeddings \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bge-m3",
    "input": ["Hello world", "How are you?"]
  }'
import requests

response = requests.post(
    "https://taas.cloudsigma.com/v1/embeddings",
    headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"},
    json={
        "model": "bge-m3",
        "input": ["Hello world", "How are you?"]
    }
)
data = response.json()
vector = data["data"][0]["embedding"]
print(f"Dimensions: {len(vector)}")
const response = await fetch(
  "https://taas.cloudsigma.com/v1/embeddings",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "bge-m3",
      input: ["Hello world", "How are you?"],
    }),
  }
);
const data = await response.json();
console.log(`Dims: ${data.data[0].embedding.length}`);
Response · 200
{
  "object": "list",
  "model": "bge-m3",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0234, -0.0871, 0.1203, ...]
    },
    {
      "object": "embedding",
      "index": 1,
      "embedding": [0.0512, -0.0344, 0.0987, ...]
    }
  ],
  "usage": {
    "prompt_tokens": 7,
    "total_tokens": 7
  }
}

POST Rerank

/v1/rerank

Rerank a list of documents by relevance to a query. Ideal for improving retrieval quality in RAG pipelines — pass candidate documents from a vector search and get them sorted by true semantic relevance.

Request Body
FieldTypeDescription
model requiredstringReranker model ID (e.g. bge-reranker-v2-m3)
query requiredstringThe search query to rank documents against
documents requiredarrayArray of document strings to score and rank
Response Fields
FieldTypeDescription
results[].indexintegerOriginal index of the document in the input array
results[].relevance_scorenumberRelevance score (higher = more relevant). Results are sorted descending.
# Rerank documents
curl -X POST https://taas.cloudsigma.com/v1/rerank \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bge-reranker-v2-m3",
    "query": "What is quantum computing?",
    "documents": [
      "Quantum computing uses qubits to process information.",
      "Classical computers use binary bits.",
      "The weather today is sunny."
    ]
  }'
import requests

response = requests.post(
    "https://taas.cloudsigma.com/v1/rerank",
    headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"},
    json={
        "model": "bge-reranker-v2-m3",
        "query": "What is quantum computing?",
        "documents": [
            "Quantum computing uses qubits to process information.",
            "Classical computers use binary bits.",
            "The weather today is sunny."
        ]
    }
)
results = response.json()["results"]
for r in results:
    print(f"idx={r['index']} score={r['relevance_score']:.4f}")
const response = await fetch(
  "https://taas.cloudsigma.com/v1/rerank",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "bge-reranker-v2-m3",
      query: "What is quantum computing?",
      documents: [
        "Quantum computing uses qubits to process information.",
        "Classical computers use binary bits.",
        "The weather today is sunny.",
      ],
    }),
  }
);
const { results } = await response.json();
Response · 200
{
  "model": "bge-reranker-v2-m3",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.9823
    },
    {
      "index": 1,
      "relevance_score": 0.4512
    },
    {
      "index": 2,
      "relevance_score": 0.0031
    }
  ]
}

POST Audio Transcriptions

/v1/audio/transcriptions

Transcribe audio to text using Whisper or another speech-to-text model. Send the audio file as multipart/form-data. Supports WAV, MP3, M4A, FLAC, OGG, and WebM formats.

Request (multipart/form-data)
FieldTypeDescription
file requiredfileAudio file to transcribe. Max 25 MB.
modelstringModel to use (default: whisper)
languagestringISO-639-1 language code (e.g. en, de). Auto-detected if omitted.
Response Fields
FieldTypeDescription
textstringThe transcribed text from the audio file
# Transcribe audio file
curl -X POST https://taas.cloudsigma.com/v1/audio/transcriptions \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "model=whisper"
import requests

with open("recording.wav", "rb") as f:
    response = requests.post(
        "https://taas.cloudsigma.com/v1/audio/transcriptions",
        headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"},
        files={"file": ("recording.wav", f, "audio/wav")},
        data={"model": "whisper"}
    )
result = response.json()
print(result["text"])
const formData = new FormData();
formData.append("file", audioBlob, "recording.wav");
formData.append("model", "whisper");

const response = await fetch(
  "https://taas.cloudsigma.com/v1/audio/transcriptions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"
    },
    body: formData,
  }
);
const { text } = await response.json();
console.log(text);
Response · 200
{
  "text": "Hello, this is a test recording for the transcription API."
}

POST Text to Speech

/v1/audio/speech

Convert text to natural-sounding audio. The response is a binary audio stream (WAV or MP3). Use the Kokoro model for high-quality multilingual speech synthesis.

Request Body
FieldTypeDescription
model requiredstringTTS model ID (e.g. kokoro)
input requiredstringText to synthesize into speech. Max 4096 characters.
voicestringVoice identifier (model-specific). Omit for model default.
response_formatstringAudio format: mp3 or wav (default: mp3)
speednumberSpeaking speed multiplier 0.25–4.0 (default: 1.0)
Response

Returns raw audio binary data with Content-Type: audio/mpeg (MP3) or audio/wav. Save the response body directly to a file.

# Text to speech — save to file
curl -X POST https://taas.cloudsigma.com/v1/audio/speech \
  -H "Authorization: Bearer taas_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kokoro",
    "input": "Welcome to AI Mission Control.",
    "voice": "af_sarah"
  }' \
  --output speech.mp3
import requests

response = requests.post(
    "https://taas.cloudsigma.com/v1/audio/speech",
    headers={"Authorization": "Bearer taas_xxxxxxxxxxxxxxxx"},
    json={
        "model": "kokoro",
        "input": "Welcome to AI Mission Control.",
        "voice": "af_sarah"
    }
)
with open("speech.mp3", "wb") as f:
    f.write(response.content)
print("Saved speech.mp3")
const response = await fetch(
  "https://taas.cloudsigma.com/v1/audio/speech",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer taas_xxxxxxxxxxxxxxxx",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "kokoro",
      input: "Welcome to AI Mission Control.",
      voice: "af_sarah",
    }),
  }
);
const audioBuffer = await response.arrayBuffer();
// Play or save the audio binary
Response · 200
# Binary audio data (MP3 or WAV)
# Content-Type: audio/mpeg
# Save response body directly to speech.mp3

GET Health Check

/health

Returns the current health status of the 1Stack AI Mission Control API gateway. Use this endpoint to verify connectivity and confirm the service is operational before sending inference requests. No authentication required.

Response Fields
FieldTypeDescription
statusstringAlways "ok" when the service is healthy
# Check API health
curl https://taas.cloudsigma.com/health
import requests

response = requests.get("https://taas.cloudsigma.com/health")
print(response.json())  # {"status": "ok"}
const response = await fetch(
  "https://taas.cloudsigma.com/health"
);
const data = await response.json();
console.log(data.status); // "ok"
Response · 200
{
  "status": "ok"
}