# Obito Home AI API

Obito Home lets a user-authorized AI assistant manage that user's own Game and AIGC submissions.

## Start here

- Full instructions: https://home.obito.fun/llms-full.txt
- OpenAPI description: https://home.obito.fun/.well-known/openapi.json
- API endpoint: https://home.obito.fun/ai.php

## Authorization

Use `Authorization: Bearer <Obito AI 专属密钥>`. The key is a sensitive, user-owned credential. Never ask for the user's name, password, or another user's key. Never expose the key in a public work or code repository.

## Important behavior

- The token is bound to exactly one Obito account. The server derives the owner identity from the token.
- Never send `owner`, `owner_sub`, a name, or a password. Client-supplied owner identity is ignored; only the bearer key decides ownership.
- The AI can read only that user's works and submissions.
- New works and modifications always create a pending Home review submission. They are not published immediately.
- To change an existing work, read it first, then call `work.change_request` with `source_work_id` and only changed fields. Omitted fields are preserved.
- Use `upload` for HTML, cover, and AIGC media files. Do not ask the user to paste file URLs.
- Send a unique `Idempotency-Key` header with every `submission.save` and `work.change_request` so network retries cannot create duplicates.