XonaXona Docs
OverviewResourcesxPayInference

AI & Social

Social intelligence and agentic services — X persona, news, chat agents, and trend analysis.

Social intelligence and agentic services — X persona, news, chat agents, and trend analysis. 9 endpoints, each gated by the x402 payment protocol and settled in USDC. Connect the same endpoints over the MCP server for agent-to-agent use.

Claude Opus 4.6

Claude Opus 4.6 text generation (Anthropic). Dynamic pricing: estimated input tokens at $0.005/1K + output tier ceiling at $0.025/1K. Tiers: small (1K output tokens), medium (4K), large (8K). Supports system prompt and image input.

POST /llm/claude-opus-4-6

Price

$0.03–$0.20 by tier + input

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
prompttextareaYesThe user prompt for Claude (counts toward input cost at $0.005/1K tokens)
system_prompttextareaNoOptional system prompt (counts toward input cost)
tierselectNoOutput size tier: small (1024 tokens, ~$0.03), medium (4096, ~$0.10), large (8192, ~$0.20) One of: small, medium, large.
imagestringNoOptional image URL for vision input (adds a flat 1600-token input charge, ~$0.008)

Response

Returns text (the generated response), model, tier, usage (input/output token counts), and metadata

Example

curl -X POST "https://api.xona-agent.com/llm/claude-opus-4-6" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "prompt": "Explain x402 payments in two paragraphs",
  "system_prompt": "You are a helpful assistant.",
  "tier": "small",
  "image": "https://example.com/image.jpg"
}'

Creative Director

AI-powered creative research and prompt refinement using X and Google. Analyzes trends, and transforms your idea into an optimized generation plan.

POST /image/creative-director

Price

$0.03

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
ideatextareaYesYour creative idea or concept to research and refine
reference_imagesstring[]NoURLs of reference images (optional)

Response

Returns intent analysis, research results from X/Google, and a generation direction plan

Example

curl -X POST "https://api.xona-agent.com/image/creative-director" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "idea": "e.g., A futuristic Solana-themed artwork with neon colors and blockchain elements",
  "reference_images": "https://example.com/image.jpg"
}'

Designer

AI image generation with intelligent style blending. Takes your prompt and style keywords, refines them together, and generates a high-quality image.

POST /image/designer

Price

$0.06

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
prompttextareaYesDetailed prompt description for the image
stylestring[]NoStyle keywords to blend into the prompt
aspect_ratiostringNoImage aspect ratio
referenceImagestring[]NoURLs of reference images for style/composition guidance

Response

Returns generated image URL, refined prompt, and generation metadata

Example

curl -X POST "https://api.xona-agent.com/image/designer" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "prompt": "A vibrant digital illustration depicting futuristic Solana tokens with neon colors...",
  "style": "digital art, futuristic, neon",
  "aspect_ratio": "1:1",
  "referenceImage": "https://example.com/reference.jpg"
}'

Gemini 3.5 Flash

Gemini 3.5 Flash text generation (Google). Dynamic pricing: estimated input tokens at $0.0015/1K + output tier ceiling at $0.009/1K. Tiers: small (1K output tokens), medium (4K), large (8K). Supports system prompt.

POST /llm/gemini-3.5-flash

Price

$0.01–$0.07 by tier + input

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
prompttextareaYesThe user prompt for Gemini (counts toward input cost at $0.0015/1K tokens)
system_prompttextareaNoOptional system prompt (counts toward input cost)
tierselectNoOutput size tier: small (1024 tokens, ~$0.01), medium (4096, ~$0.04), large (8192, ~$0.07) One of: small, medium, large.

Response

Returns text (the generated response), model, tier, usage (input/output token counts), and metadata

Example

curl -X POST "https://api.xona-agent.com/llm/gemini-3.5-flash" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "prompt": "Write assembly to move a file between folders",
  "system_prompt": "You are a helpful assistant.",
  "tier": "small"
}'

GPT-5.2

GPT-5.2 text generation (OpenAI). Dynamic pricing: estimated input tokens at $0.00175/1K + output tier ceiling at $0.014/1K. Tiers: small (1K output tokens), medium (4K), large (8K). Supports image input and reasoning effort control.

POST /llm/gpt-5.2

Price

$0.01–$0.11 by tier + input

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
prompttextareaYesThe user prompt for GPT-5.2 (counts toward input cost at $0.00175/1K tokens)
tierselectNoOutput size tier: small (1024 tokens, ~$0.01), medium (4096, ~$0.06), large (8192, ~$0.11). Reasoning tokens count toward this ceiling. One of: small, medium, large.
reasoning_effortselectNoReasoning depth. Higher effort uses more output tokens (counted in the tier ceiling). One of: low, medium, high.
imagestringNoOptional image URL for vision input (adds a flat 1600-token input charge, ~$0.003)

Response

Returns text (the generated response), model, tier, usage (input/output token counts), and metadata

Example

curl -X POST "https://api.xona-agent.com/llm/gpt-5.2" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "prompt": "Explain this paradox through a mathematical proof",
  "tier": "small",
  "reasoning_effort": "medium",
  "image": "https://example.com/image.jpg"
}'

NVIDIA NIM

OpenAI-compatible chat completions served on NVIDIA-optimized frontier models (Nemotron 3 Ultra, Kimi K2.6, DeepSeek V4 Pro, GLM-5.1). Pick a model via the Model field; price varies by tier (premium / flagship). Also available drop-in at POST /v1/chat/completions with an API key + prepaid credits.

POST /llm/nim

Price

$0.006–$0.015 by tier

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
modelselectYesModel to run. Price depends on the tier shown. One of: kimi-k2.6, glm-5.1, nemotron-3-ultra-550b, deepseek-v4-pro.
prompttextareaYesThe user prompt (or use messages)
system_prompttextareaNoOptional system prompt
max_tokensnumberNoOptional cap on output tokens
temperaturenumberNoOptional sampling temperature (0–2)

Response

Returns text, model, and usage (prompt/completion/total tokens). OpenAI-compatible response when called via /v1/chat/completions.

Example

curl -X POST "https://api.xona-agent.com/llm/nim" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "model": "deepseek-v4-pro",
  "prompt": "Explain x402 payments in two paragraphs",
  "system_prompt": "You are a helpful assistant.",
  "max_tokens": "1024",
  "temperature": "0.7"
}'

Verified Inference (Prova)

OpenAI-compatible chat completions that run inside a TEE (NVIDIA + Intel), are hardware-attested, and anchored on Solana. Every response returns an on-chain proof + Solscan link. Pick a model via the Model field; price varies by tier (standard / premium / flagship).

POST /llm/prova

Price

$0.0014–$0.01 by tier

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
modelselectYesModel to run. Price depends on the tier shown. One of: deepseek-v4-flash, gpt-oss-20b, qwen-2.5-7b, qwen3.5-27b, qwen3.6-27b, qwen3-vl-30b, gpt-oss-120b, gemma-4-31b, qwen3.5-122b, kimi-k2.6, glm-5.2, deepseek-v4-pro.
prompttextareaYesThe user prompt
system_prompttextareaNoOptional system prompt
max_tokensnumberNoOptional cap on output tokens
temperaturenumberNoOptional sampling temperature (0–2)

Response

Returns text, model, verified (bool), usage, and proof (receipt_id, attested, tee_key, request/response hashes, solscan_url, verify_url) plus a metadata attestation summary

Example

curl -X POST "https://api.xona-agent.com/llm/prova" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "model": "deepseek-v4-flash",
  "prompt": "Explain TEE attestation in two sentences",
  "system_prompt": "You are a helpful assistant.",
  "max_tokens": "1024",
  "temperature": "0.7"
}'

X News

Extract latest news from X (Twitter) username, generate draft tweet and banner with Xona.

POST /ai/x-news

Price

$0.5

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
x_usernamestringYesX (Twitter) username with or without @ symbol
x_personastringNoX (Twitter) username to mimic persona/style for tweet draft (optional)

Response

Returns success, x_username, and trending_news with title (max 4 words), tweet_draft, and banner_url

Example

curl -X POST "https://api.xona-agent.com/ai/x-news" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "x_username": "@username or username",
  "x_persona": "@username or username"
}'

X Persona

Extract structured persona from X (Twitter) username. Analyzes posts, profile, and communication style to generate persona, style profile, content patterns, and avatar prompt.

POST /ai/x-persona

Price

$0.05

Network

Solana

x402

v2

Request parameters

ParameterTypeRequiredDescription
x_usernamestringYesX (Twitter) username with or without @ symbol

Response

Returns persona (summary, tone, core topics, beliefs), style_profile (writing style, voice), content_patterns (formats, topics, posting behavior), and avatar (image type, prompt, reference images)

Example

curl -X POST "https://api.xona-agent.com/ai/x-persona" \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <x402-payment-payload>" \
  -d '{
  "x_username": "@username or username"
}'

On this page