Model Examples

from definable.model.openai import OpenAIChat
from definable.model.message import Message

model = OpenAIChat(id="gpt-4o-mini")

messages = [
    Message(role="system", content="You are a helpful assistant."),
    Message(role="user", content="What is the capital of France?"),
]

response = model.invoke(
    messages=messages,
    assistant_message=Message(role="assistant", content=""),
)

print(response.content)
print(f"Tokens: {response.response_usage.total_tokens}")

python definable/examples/models/01_basic_invoke.py

import asyncio
from definable.model.openai import OpenAIChat
from definable.model.message import Message

async def main():
    model = OpenAIChat(id="gpt-4o-mini")
    messages = [Message(role="user", content="Hello!")]
    response = await model.ainvoke(
        messages=messages,
        assistant_message=Message(role="assistant", content=""),
    )
    print(response.content)

asyncio.run(main())

python definable/examples/models/02_async_invoke.py

from definable.model.openai import OpenAIChat
from definable.model.message import Message

model = OpenAIChat(id="gpt-4o-mini")
messages = [Message(role="user", content="Tell me a short story.")]

for chunk in model.invoke_stream(
    messages=messages,
    assistant_message=Message(role="assistant", content=""),
):
    if chunk.content:
        print(chunk.content, end="", flush=True)

python definable/examples/models/03_streaming.py

import json
from pydantic import BaseModel
from definable.model.openai import OpenAIChat
from definable.model.message import Message

class Movie(BaseModel):
    title: str
    year: int
    genre: str

model = OpenAIChat(id="gpt-4o-mini")
response = model.invoke(
    messages=[Message(role="user", content="Recommend a sci-fi movie.")],
    assistant_message=Message(role="assistant", content=""),
    response_format=Movie,
)
movie = Movie(**json.loads(response.content))
print(movie)  # Movie(title=..., year=..., genre=...)

python definable/examples/models/04_structured_output.py

from definable.model.openai import OpenAIChat
from definable.model.deepseek import DeepSeekChat
from definable.model.moonshot import MoonshotChat
from definable.model.xai import xAI

providers = [
    OpenAIChat(id="gpt-4o-mini"),
    DeepSeekChat(id="deepseek-chat"),
    MoonshotChat(id="kimi-k2-turbo-preview"),
    xAI(id="grok-3"),
]

from definable.model.message import Message

messages = [Message(role="user", content="What is 2 + 2?")]
assistant = Message(role="assistant", content="")

for model in providers:
    response = model.invoke(messages=messages, assistant_message=assistant)
    print(f"{model.provider}: {response.content[:100]}")

python definable/examples/models/05_multi_provider.py

from definable.model.openai import OpenAIChat
from definable.model.message import Message
from definable.media import Image

model = OpenAIChat(id="gpt-4o")
response = model.invoke(
    messages=[Message(role="user", content="Describe this image.", images=[Image(url="https://example.com/photo.jpg")])],
    assistant_message=Message(role="assistant", content=""),
)
print(response.content)

python definable/examples/models/06_vision_and_audio.py