Skip to main content

​
Model Override

By default, Logic automatically routes your document execution to the optimal model based on your document’s requirements. However, you can bypass this routing and explicitly specify which model and reasoning level to use by adding the model query parameter.
Model overrides are an advanced feature. In most cases, Logic’s automatic model routing will select the best model for your use case. Only use model overrides when you have specific requirements around model selection.

​
Available Models

The model parameter accepts a model identifier in the format {model}:{reasoning_level}.
ProviderModel Overrides
OpenAI GPT-5.1gpt-5.1:none, gpt-5.1:minimal, gpt-5.1:low, gpt-5.1:medium, gpt-5.1:high
OpenAI GPT-5.2gpt-5.2:none, gpt-5.2:minimal, gpt-5.2:low, gpt-5.2:medium, gpt-5.2:high
Gemini 3 Flashgemini-3-flash:default, gemini-3-flash:low, gemini-3-flash:medium, gemini-3-flash:high
Gemini 3 Progemini-3-pro:default, gemini-3-pro:low, gemini-3-pro:medium, gemini-3-pro:high
Groqgroq-llama-4:default, groq-gpt-oss:default

​
Reasoning Levels

The reasoning level controls how much “thinking” the model does before responding:
  • none/default — Standard response without extended reasoning
  • minimal — Light reasoning for simple tasks
  • low — Basic reasoning for straightforward problems
  • medium — Moderate reasoning for complex tasks
  • high — Maximum reasoning for the most challenging problems
Higher reasoning levels may increase latency and cost but can improve accuracy for complex tasks.

​
Capability Validation

When using a model override, Logic validates that your chosen model supports your document’s requirements. If your document requires capabilities the model doesn’t support, you’ll receive a 400 InvalidModelOverride error.
CapabilityOpenAIGeminiGroq
PDF ProcessingSupportedSupportedLlama only
Image ProcessingSupportedSupportedLlama only
Audio ProcessingNot supportedSupportedNot supported
HIPAA ComplianceNot supportedSupportedNot supported
Tool UsageSupportedNot supportedSupported
For example, if your document processes audio input and you specify ?model=gpt-5.1:low, the request will fail because OpenAI models don’t support audio processing.

​
Example Usage

Below are examples showing how to specify a model override when executing a document. 
curl -X POST 'https://api.logic.inc/v1/documents/{document_id}/executions?model=gpt-5.1:low'
    -H "Authorization: Bearer $LOGIC_API_TOKEN"
    -H "Content-Type: application/json"
    -d '{
        /* your input JSON here */
    }'

​
Error Handling

If you specify an invalid model or a model that doesn’t support your document’s requirements, you’ll receive a 400 InvalidModelOverride error: 
{
  "error": {
    "code": "InvalidModelOverride",
    "message": "The specified model 'gpt-5.1:low' does not support audio processing required by this document"
  }
}