Multimodal Capabilities

AgnicPay AI Gateway supports multiple input modalities beyond text, allowing you to send images, PDFs, audio, and video files to compatible models through our unified API. This enables rich multimodal interactions for a wide variety of use cases.

Supported Modalities

Images

Send images to vision-capable models for analysis, description, OCR, and more. AgnicPay supports multiple image formats and both URL-based and base64-encoded images.

Learn more about image inputs →

Image Generation

Generate images from text prompts using AI models with image output capabilities. Create high-quality images based on your descriptions.

Learn more about image generation →

PDFs

Process PDF documents with compatible models. Our intelligent PDF parsing system extracts text and handles both text-based and scanned documents.

Learn more about PDF processing →

Audio

Send audio files to speech-capable models for transcription, analysis, and processing. AgnicPay supports common audio formats with automatic routing to compatible models.

Learn more about audio inputs →

Video

Send video files to video-capable models for analysis, description, object detection, and action recognition. Process multiple video formats for comprehensive video understanding tasks.

Learn more about video inputs →

Getting Started

All multimodal inputs use the same /v1/chat/completions endpoint with the messages parameter. Different content types are specified in the message content array:

You can combine multiple modalities in a single request, and the number of files you can send varies by provider and model.

Model Compatibility

Not all models support every modality. AgnicPay automatically routes requests to compatible models:

Use the Models API to find models that support your desired input modalities by checking the architecture.input_modalities field.

Input Format Support

AgnicPay supports both direct URLs and base64-encoded data for multimodal inputs:

URLs (Recommended for public content)

Images: https://example.com/image.jpg
PDFs:   https://example.com/document.pdf
Video:  https://youtube.com/watch?v=... (provider-specific)

Base64 Encoding (Required for local files)

Images: data:image/jpeg;base64,{base64_data}
PDFs:   data:application/pdf;base64,{base64_data}
Audio:  Raw base64 string with format specification
Video:  data:video/mp4;base64,{base64_data}

Quick Example

from openai import OpenAI
 
client = OpenAI(
    api_key="agnic_tok_YOUR_TOKEN",
    base_url="https://api.agnic.ai/v1"
)
 
# Send an image for analysis
response = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What's in this image?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/image.jpg"
                    }
                }
            ]
        }
    ]
)
 
print(response.choices[0].message.content)

Pricing

Multimodal content is priced based on the modality:

• Images: Typically priced per image or as input tokens
• PDFs: Priced based on page count or as input tokens
• Audio: Priced as input tokens based on duration
• Video: Priced as input tokens based on duration and resolution

Next Steps