# Yoofooz API Readiness Report

## API
**Name:** xAI
**Docs URL:** https://docs.x.ai/developers/quickstart.md
**Domain:** docs.x.ai
**Generated At:** 2026-10-25T22:00:56.835292+00:00

## Certification
**Agent Readiness Score:** 65/100
**Certification Level:** Agent-Compatible With Gaps

## Agent Commerce Readiness
**Agent Commerce Score:** 30/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 10
- Authentication Clarity: 5
- Error Handling: 10
- Rate Limit Clarity: 10
- Agent Safe Workflow Support: 10
- Sandbox Availability: 0
- Webhook Event Support: 0
- Commercial Trust: 0
- Developer Experience: 10

## Strengths
- Documentation clarity
- Machine-readable specification (OpenAPI/GraphQL/etc.)
- Error handling and status codes
- Rate-limit / quota behavior
- Agent-safe workflow primitives (idempotency, retries)
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Authentication model clarity signal is partial; clearer documentation recommended.
- Sandbox / test-mode availability signal not detected in docs.
- Webhook / event support signal not detected in docs.
- Commercial trust (status, SLA, compliance) signal not detected in docs.

## Recommended Next Steps
- Strengthen: Document authentication clearly (API keys, OAuth scopes, bearer tokens, secret/publishable key handling).
- Provide a sandbox / test mode with test API keys for safe agent testing.
- Expose webhook/event docs including event types, signature verification, and retry delivery.
- Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable).

## Evidence Signals

### Documentation clarity
- **Source:** https://docs.x.ai/developers/quickstart.md
- **Matched:** quickstart, request, response, docs, guide, overview
- **Evidence:** "quickstart # quickstart welcome! in this guide, we'll walk you through the basics of using the spacexsi api, from creating an account to making your first..."

- **Source:** https://docs.x.ai/developers/model-capabilities/text/structured-outputs.md
- **Matched:** parameters, request, response, reference, overview
- **Evidence:** "...and report generation. > [!tip] > > when using supported schema features, the response is guaranteed to match your schema. there are two ways to request structured outputs from the model. the primary and most flexible method is to use the `response_format` parameter. by setting `response_format.type`..."

### Machine-readable specification (OpenAPI/GraphQL/etc.)
- **Source:** https://docs.x.ai/developers/model-capabilities/text/structured-outputs.md
- **Matched:** json schema, schema
- **Evidence:** "...is through tool calling. when you define tools, spacexsi models will always generate tool call arguments that strictly conform to the tool’s input json schema (the `strict` flag is implicitly always `true`). > [!note] > > tool schemas follow the same json schema support rules described on this page. see..."

- **Source:** https://docs.x.ai/developers/pricing.md
- **Matched:** endpoints
- **Evidence:** "...is served at the default tier instead, standard rates apply. > [!note] > > priority processing is available for chat completions and responses endpoints only. it is not supported for image generation, video generation, or [batch api](/developers/advanced-api-usage/batch-api) requests. see [priority..."

### Authentication model clarity
- **Source:** https://docs.x.ai/developers/quickstart.md
- **Matched:** authorization, api key, keys
- **Evidence:** "...this function and explain the bug: function median(a) ', ) print(response.output_text) ``` ```bash curl https://api.x.ai/v1/responses \ -h 'authorization: bearer $xai_api_key' \ -h 'content-type: application/json' \ -d ' ' ``` ```javascript customlanguage='javascriptopenaisdk' import openai from..."

- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** authorization
- **Evidence:** "...that you'll use to add requests and retrieve results. ```bash curl -x post https://api.x.ai/v1/batches \\ -h 'content-type: application/json' \\ -h 'authorization: bearer $xai_api_key' \\ -d ' ' ``` ```javascriptwithoutsdk // create a batch with a descriptive name const response = await..."

### Error handling and status codes
- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** idempotency, 500, errors
- **Evidence:** "...when you're processing hundreds or thousands of items. if you don't provide an id, we generate a uuid for you. using your own ids is useful for idempotency (ensuring a request is only processed once) and for linking batch requests to records in your own system. ```bash curl -x post..."

- **Source:** https://docs.x.ai/developers/model-capabilities/text/structured-outputs.md
- **Matched:** 400
- **Evidence:** "...values not listed under [string formats](#string-formats) * constraints exceeding the limits above rejected schemas the following will return a `400` error: * `enum` or `anyof` with zero variants * properties with a schema of `true` or `false` * `maxcontains` / `mincontains` * `items` as an array..."

### Rate-limit / quota behavior
- **Source:** https://docs.x.ai/developers/pricing.md
- **Matched:** rate limit, rate limits, limits
- **Evidence:** "...| token pricing | standard rates | discounted rates (varies by model) | | response time | immediate (seconds) | typically within 24 hours | | rate limits | per-minute limits apply | requests don't count towards rate limits | the batch discount applies to all token types — input tokens, output tokens,..."

- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** rate limit, rate limits, limits
- **Evidence:** "advanced api usage # batch api the batch api lets you process large volumes of requests asynchronously with reduced pricing and higher rate limits. for pricing details, see [batch api pricing](/developers/pricing#batch-api-pricing). if you need lower latency on real-time requests instead, see..."

### Agent-safe workflow primitives (idempotency, retries)
- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** idempotency, test mode
- **Evidence:** "...when you're processing hundreds or thousands of items. if you don't provide an id, we generate a uuid for you. using your own ids is useful for idempotency (ensuring a request is only processed once) and for linking batch requests to records in your own system. ```bash curl -x post..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://docs.x.ai/developers/pricing.md
- **Matched:** support
- **Evidence:** "...servers | token-based | † all tool names work in the responses api. in the grpc api (python xai sdk), `code_interpreter` and `file_search` are not supported. \* only applies to images and videos found by search tools — not to images passed directly in messages. x search is billed per item fetched..."

- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** support
- **Evidence:** "...need lower latency on real-time requests instead, see [priority processing](/developers/advanced-api-usage/priority-processing). > [!note] > model support > > not every model accepts batch api requests. see details on each [model page](/developers/models). unsupported models reject batch requests. what..."

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://docs.x.ai/developers/quickstart.md
- **Matched:** quickstart, sdk, cli
- **Evidence:** "quickstart # quickstart welcome! in this guide, we'll walk you through the basics of using the spacexsi api, from creating an account to making your first..."

- **Source:** https://docs.x.ai/developers/advanced-api-usage/batch-api.md
- **Matched:** sdk, cli, dashboard
- **Evidence:** "...post https://api.x.ai/v1/batches \\ -h 'content-type: application/json' \\ -h 'authorization: bearer $xai_api_key' \\ -d ' ' ``` ```javascriptwithoutsdk // create a batch with a descriptive name const response = await fetch('https://api.x.ai/v1/batches', ); const batch = await response.json();..."

## AI Analyst Summary
_Provider: nvidia | Model: nvidia/nemotron-3.5-super-vl-120b-a12b_

xAI API scores 65/100 and is Agent-Compatible With Gaps, with strong documentation, specs, error handling, rate limits, agent-safe workflows, and developer experience, but lacks sandbox, webhooks, and commercial trust signals.

**Credibility Notes:**
- Agent-compatible with a mid-tier readiness score of 65/100.
- Core technical foundations like specs and error handling are solid.
- Trust and integration signals including SLA, sandbox, and webhooks are missing.

**Next Actions:**
- Document authentication clearly including API keys, OAuth scopes, and bearer token handling.
- Provide a sandbox or test mode with test API keys for safe agent testing.
- Publish status page, SLA, and security or compliance posture such as SOC 2 and GDPR.

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.