AI API

Use this section for sessions, messages, streaming, models, files, memory, generative media, analyses, suggestions, and Chao context.

Base Path

https://api.chainabit.com/api/v1/ai

Authentication

All AI endpoints require a valid JWT Bearer token and an active AI entitlement.

Environment Variables

export BASE_URL="https://api.chainabit.com/api/v1"
export TOKEN="your-access-token"

Sections

• Features & Runs for run creation, streaming, cancel, and retry.
• Sessions for persistent conversations.
• Messages for message history, streaming, and stop controls.
• Models for the model catalog and pricing.
• Providers for the provider list and status.
• Files for file upload and metadata management.
• Memory for persistent memory entries.
• Generative Media for context-aware image, video, and audio jobs.
• Chainy Analysis for AI analysis of a Chainy and task decomposition into sub-bits.
• Analyses for AI-generated analyses.
• Spark for single-shot context-aware suggestions (no session required).
• Suggestions for AI-generated suggestions and review actions.
• Chao Context for resolved Chao context.

Notes

• AI endpoints consume credits from your wallet.
• Use SSE endpoints for live streaming.
• Files are uploaded with a presigned URL flow.
• Assistant follow-up cards are returned as structured JSON suggestions, not inline markdown text.
• Suggestion cards can be disabled per user through aiMessageSuggestionsEnabled in Preferences.