overlay: 1.0.0
info:
  title: API Evangelist overlay for さくらの AI Engine Inference API
  version: 1.0.0
extends: ../openapi/_original/sakura-internet-ai-engine-inference-openapi.yml
x-generated: '2026-10-09'
x-method: generated
x-source: openapi/sakura-internet-ai-engine-inference-openapi.yml
x-rationale: 'Enhancements captured without mutating the original: derives tags for 8 untagged operations
  from the first path segment; links the provider-hosted docs as externalDocs.'
actions:
- target: $.paths['/v1/chat/completions'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - chat
- target: $.paths['/v1/responses'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - responses
- target: $.paths['/v1/messages'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - messages
- target: $.paths['/v1/audio/transcriptions'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - audio
- target: $.paths['/v1/embeddings'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - embeddings
- target: $.paths['/v1/audio/speech'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - audio
- target: $.paths['/tts/v1/audio_query'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - tts
- target: $.paths['/tts/v1/synthesis'].post
  description: Derived tags (missing in original; derived from method + path).
  update:
    tags:
    - tts
- target: $
  description: Link the provider-hosted human documentation.
  update:
    externalDocs:
      url: https://manual.sakura.ad.jp/api/cloud/portal/ai-engine-inference-api/index.html
      description: SAKURA internet documentation
- target: $.info
  description: Agent-surface hints from the API Evangelist profile.
  update:
    x-api-evangelist:
      provider: sakura-internet
      mcp: mcp/sakura-internet-mcp.yml
      tool_crosswalk: mcp/sakura-internet-tool-crosswalk.yml
      llms: llms/sakura-internet-llms.txt