> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Validate a post > Runs every structural and platform check that POST /posts would run, without creating anything. 当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 ## 请求规范 * **方法与路径:** POST /apis/v1/social/tools/validate/post * **可用状态:** enabled * **请求 URL 模板:** `https://api.aisa.one/apis/v1/social/tools/validate/post` * **Runtime 事实版本:** 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd [完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/aisa-social.json) 有效请求与价格声明（包括认证和引用的 schema）： ```json theme={null} { "operationId": "post_aisa_social_apis_v1_social_tools_validate_post", "method": "POST", "path": "/apis/v1/social/tools/validate/post", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "example": { "content": "Our spring collection is live.", "mediaItems": [ { "mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6", "type": "video" } ], "platforms": [ { "accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3", "platform": "tiktok", "platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" } } ], "profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4", "scheduledFor": "2026-11-20T15:00:00Z", "timezone": "America/New_York" }, "schema": { "additionalProperties": false, "properties": { "content": { "type": [ "string", "null" ] }, "isDraft": { "type": [ "boolean", "null" ] }, "mediaItems": { "items": { "additionalProperties": false, "properties": { "altText": { "type": [ "string", "null" ] }, "mediaId": { "pattern": "^med_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "thumbnailUrl": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "platforms": { "items": { "additionalProperties": false, "allOf": [ { "if": { "properties": { "platform": { "enum": [ "tiktok" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "Required to schedule or publish: privacyLevel, allowComment. Also required for video: allowDuet, allowStitch. Must be true, from the user: contentPreviewConfirmed, expressConsentGiven.", "properties": { "allowComment": { "description": "Allow comments. Must be false when creator-info reports commentDisabled.", "type": "boolean" }, "allowDuet": { "description": "Allow duets; required for video. Must be false when creator-info reports duetDisabled.", "type": "boolean" }, "allowStitch": { "description": "Allow stitches; required for video. Must be false when creator-info reports stitchDisabled.", "type": "boolean" }, "brandPartnerPromote": { "description": "Also disclose a paid partnership; only alongside commercialContentType brand_organic.", "type": "boolean" }, "commercialContentType": { "description": "Commercial content disclosure; one of commercialContentTypes from creator-info. brand_content cannot be SELF_ONLY.", "enum": [ "none", "brand_organic", "brand_content" ], "type": "string" }, "contentPreviewConfirmed": { "description": "The user previewed exactly this content. Must be true and must come from the user.", "type": "boolean" }, "description": { "description": "Long caption for photo posts.", "maxLength": 4000, "minLength": 1, "type": "string" }, "expressConsentGiven": { "description": "The user consented to posting. Must be true and must come from the user.", "type": "boolean" }, "isBrandOrganicPost": { "description": "Also disclose the creator's own brand; only alongside commercialContentType brand_content.", "type": "boolean" }, "mediaType": { "description": "Overrides the media type derived from the media items.", "enum": [ "video", "photo" ], "type": "string" }, "privacyLevel": { "description": "One of privacyLevelOptions from GET /accounts/{accountId}/tiktok/creator-info for this mediaType.", "maxLength": 64, "minLength": 1, "type": "string" }, "videoMadeWithAi": { "description": "Label the post as AI-generated.", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "instagram" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "collaborators": { "description": "Up to 3 usernames to invite as collaborators (feed and Reels).", "items": { "maxLength": 64, "minLength": 1, "type": "string" }, "maxItems": 3, "type": "array" }, "contentType": { "description": "story publishes a Story.", "enum": [ "story" ], "type": "string" }, "firstComment": { "description": "First comment added after publishing (not on Stories).", "maxLength": 2200, "minLength": 1, "type": "string" }, "isAiGenerated": { "description": "Label the post as containing AI-generated media.", "type": "boolean" }, "shareToFeed": { "description": "Reels only: also show the Reel on the main feed (default true).", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "twitter", "x" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "madeWithAi": { "description": "Label the post as containing AI-generated media.", "type": "boolean" }, "poll": { "additionalProperties": false, "description": "A poll; cannot be combined with media or threadItems.", "properties": { "duration_minutes": { "maximum": 10080, "minimum": 5, "type": "integer" }, "options": { "items": { "maxLength": 25, "minLength": 1, "type": "string" }, "maxItems": 4, "minItems": 2, "type": "array" } }, "required": [ "options", "duration_minutes" ], "type": "object" }, "replySettings": { "description": "Who can reply.", "enum": [ "following", "mentionedUsers", "subscribers", "verified" ], "type": "string" }, "threadItems": { "description": "The whole thread; the first item is the root post. Cannot be combined with poll.", "items": { "additionalProperties": false, "properties": { "content": { "description": "Text of this post.", "maxLength": 25000, "minLength": 1, "type": "string" } }, "required": [ "content" ], "type": "object" }, "minItems": 1, "type": "array" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "youtube" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "Required to schedule or publish: madeForKids.", "properties": { "containsSyntheticMedia": { "description": "Label the video as containing synthetic (AI-generated) content.", "type": "boolean" }, "firstComment": { "description": "First comment posted after upload.", "maxLength": 10000, "minLength": 1, "type": "string" }, "madeForKids": { "description": "COPPA: whether the video is made for kids. Required, and must be the user's explicit choice.", "type": "boolean" }, "title": { "description": "Video title.", "maxLength": 100, "minLength": 1, "type": "string" }, "visibility": { "description": "Video visibility.", "enum": [ "public", "private", "unlisted" ], "type": "string" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "facebook" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "contentType": { "description": "story or reel; omitted is a feed post.", "enum": [ "story", "reel" ], "type": "string" }, "firstComment": { "description": "First comment added after publishing (not on stories).", "maxLength": 8000, "minLength": 1, "type": "string" }, "pageId": { "description": "Page to post to when the account manages several.", "maxLength": 64, "minLength": 1, "type": "string" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "linkedin" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "linkedin accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "pinterest" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "", "properties": { "isAiGenerated": { "description": "Label the Pin as AI modified.", "type": "boolean" } }, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "threads" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "threads accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } }, { "if": { "properties": { "platform": { "enum": [ "reddit" ] } }, "required": [ "platform" ] }, "then": { "properties": { "platformSpecificData": { "anyOf": [ { "type": "null" }, { "additionalProperties": false, "description": "reddit accepts no platformSpecificData yet.", "properties": {}, "type": "object" } ] } } } } ], "properties": { "accountId": { "pattern": "^acc_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "customContent": { "type": [ "string", "null" ] }, "customMedia": { "items": { "additionalProperties": false, "properties": { "altText": { "type": [ "string", "null" ] }, "mediaId": { "pattern": "^med_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "thumbnailUrl": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "type": { "type": [ "string", "null" ] }, "url": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "platform": { "enum": [ "tiktok", "instagram", "twitter", "youtube", "facebook", "linkedin", "pinterest", "threads", "reddit", "x", null ], "type": [ "string", "null" ] }, "platformSpecificData": { "additionalProperties": {}, "description": "Platform options, checked against the platform registry: unknown fields are rejected with unknown_field. The accepted fields depend on platform; fields required to schedule or publish are named in each description.", "type": [ "object", "null" ] }, "scheduledFor": { "format": "date-time", "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "type": [ "array", "null" ] }, "profileId": { "pattern": "^prf_[0-9A-Za-z]{22}$", "type": [ "string", "null" ] }, "publishNow": { "type": [ "boolean", "null" ] }, "scheduledFor": { "format": "date-time", "type": [ "string", "null" ] }, "timezone": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] } }, "type": "object" } } }, "required": true }, "x-aisa-status": "enabled", "x-aisa-pricing": { "description": "This operation does not settle a customer usage charge.", "kind": "no_customer_charge" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## 费用与请求规则 当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。 ## OpenAPI ````yaml reference-contracts/zh/aisa-social.json POST /apis/v1/social/tools/validate/post openapi: 3.1.0 info: description: '' title: AIsa Social version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: [] x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' composer_version: '27' response_pending: [] document_hash: sha256:7f9742cb1ea233c648dcb290fdfbf24e53a27dcf900ec1386f83a8ef2e6b1bf9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: aisa-social x-aisa-catalogs: aisa-social: title: AIsa Social description: '' x-aisa-document: facts_hash: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd generator_version: '3' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/social/tools/validate/post: post: summary: Validate a post description: >- Runs every structural and platform check that POST /posts would run, without creating anything. 当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 operationId: post_aisa_social_apis_v1_social_tools_validate_post requestBody: content: application/json: example: content: Our spring collection is live. mediaItems: - mediaId: med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6 type: video platforms: - accountId: acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3 platform: tiktok platformSpecificData: privacyLevel: PUBLIC_TO_EVERYONE profileId: prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4 scheduledFor: '2026-11-20T15:00:00Z' timezone: America/New_York schema: additionalProperties: false properties: content: type: - string - 'null' isDraft: type: - boolean - 'null' mediaItems: items: additionalProperties: false properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' platforms: items: additionalProperties: false allOf: - if: properties: platform: enum: - tiktok required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- Required to schedule or publish: privacyLevel, allowComment. Also required for video: allowDuet, allowStitch. Must be true, from the user: contentPreviewConfirmed, expressConsentGiven. properties: allowComment: description: >- Allow comments. Must be false when creator-info reports commentDisabled. type: boolean allowDuet: description: >- Allow duets; required for video. Must be false when creator-info reports duetDisabled. type: boolean allowStitch: description: >- Allow stitches; required for video. Must be false when creator-info reports stitchDisabled. type: boolean brandPartnerPromote: description: >- Also disclose a paid partnership; only alongside commercialContentType brand_organic. type: boolean commercialContentType: description: >- Commercial content disclosure; one of commercialContentTypes from creator-info. brand_content cannot be SELF_ONLY. enum: - none - brand_organic - brand_content type: string contentPreviewConfirmed: description: >- The user previewed exactly this content. Must be true and must come from the user. type: boolean description: description: Long caption for photo posts. maxLength: 4000 minLength: 1 type: string expressConsentGiven: description: >- The user consented to posting. Must be true and must come from the user. type: boolean isBrandOrganicPost: description: >- Also disclose the creator's own brand; only alongside commercialContentType brand_content. type: boolean mediaType: description: >- Overrides the media type derived from the media items. enum: - video - photo type: string privacyLevel: description: >- One of privacyLevelOptions from GET /accounts/{accountId}/tiktok/creator-info for this mediaType. maxLength: 64 minLength: 1 type: string videoMadeWithAi: description: Label the post as AI-generated. type: boolean type: object - if: properties: platform: enum: - instagram required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: collaborators: description: >- Up to 3 usernames to invite as collaborators (feed and Reels). items: maxLength: 64 minLength: 1 type: string maxItems: 3 type: array contentType: description: story publishes a Story. enum: - story type: string firstComment: description: >- First comment added after publishing (not on Stories). maxLength: 2200 minLength: 1 type: string isAiGenerated: description: >- Label the post as containing AI-generated media. type: boolean shareToFeed: description: >- Reels only: also show the Reel on the main feed (default true). type: boolean type: object - if: properties: platform: enum: - twitter - x required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: madeWithAi: description: >- Label the post as containing AI-generated media. type: boolean poll: additionalProperties: false description: >- A poll; cannot be combined with media or threadItems. properties: duration_minutes: maximum: 10080 minimum: 5 type: integer options: items: maxLength: 25 minLength: 1 type: string maxItems: 4 minItems: 2 type: array required: - options - duration_minutes type: object replySettings: description: Who can reply. enum: - following - mentionedUsers - subscribers - verified type: string threadItems: description: >- The whole thread; the first item is the root post. Cannot be combined with poll. items: additionalProperties: false properties: content: description: Text of this post. maxLength: 25000 minLength: 1 type: string required: - content type: object minItems: 1 type: array type: object - if: properties: platform: enum: - youtube required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- Required to schedule or publish: madeForKids. properties: containsSyntheticMedia: description: >- Label the video as containing synthetic (AI-generated) content. type: boolean firstComment: description: First comment posted after upload. maxLength: 10000 minLength: 1 type: string madeForKids: description: >- COPPA: whether the video is made for kids. Required, and must be the user's explicit choice. type: boolean title: description: Video title. maxLength: 100 minLength: 1 type: string visibility: description: Video visibility. enum: - public - private - unlisted type: string type: object - if: properties: platform: enum: - facebook required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: contentType: description: story or reel; omitted is a feed post. enum: - story - reel type: string firstComment: description: >- First comment added after publishing (not on stories). maxLength: 8000 minLength: 1 type: string pageId: description: >- Page to post to when the account manages several. maxLength: 64 minLength: 1 type: string type: object - if: properties: platform: enum: - linkedin required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: >- linkedin accepts no platformSpecificData yet. properties: {} type: object - if: properties: platform: enum: - pinterest required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: '' properties: isAiGenerated: description: Label the Pin as AI modified. type: boolean type: object - if: properties: platform: enum: - threads required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: threads accepts no platformSpecificData yet. properties: {} type: object - if: properties: platform: enum: - reddit required: - platform then: properties: platformSpecificData: anyOf: - type: 'null' - additionalProperties: false description: reddit accepts no platformSpecificData yet. properties: {} type: object properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' customContent: type: - string - 'null' customMedia: items: additionalProperties: false properties: altText: type: - string - 'null' mediaId: pattern: ^med_[0-9A-Za-z]{22}$ type: - string - 'null' thumbnailUrl: type: - string - 'null' title: type: - string - 'null' type: type: - string - 'null' url: type: - string - 'null' type: - object - 'null' type: - array - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - x - null type: - string - 'null' platformSpecificData: additionalProperties: {} description: >- Platform options, checked against the platform registry: unknown fields are rejected with unknown_field. The accepted fields depend on platform; fields required to schedule or publish are named in each description. type: - object - 'null' scheduledFor: format: date-time type: - string - 'null' type: - object - 'null' type: - array - 'null' profileId: pattern: ^prf_[0-9A-Za-z]{22}$ type: - string - 'null' publishNow: type: - boolean - 'null' scheduledFor: format: date-time type: - string - 'null' timezone: type: - string - 'null' title: type: - string - 'null' type: object required: true responses: '200': content: application/json: schema: properties: issues: items: properties: accountId: pattern: ^acc_[0-9A-Za-z]{22}$ type: - string - 'null' code: type: - string - 'null' field: type: - string - 'null' message: type: - string - 'null' platform: enum: - tiktok - instagram - twitter - youtube - facebook - linkedin - pinterest - threads - reddit - googlebusiness - googleanalytics - bluesky - telegram - slack - snapchat - hubspot - microsoft - null type: - string - 'null' type: - object - 'null' type: - array - 'null' valid: type: - boolean - 'null' type: object description: Success default: content: application/json: schema: properties: error: properties: code: type: - string - 'null' details: additionalProperties: {} type: - object - 'null' message: type: - string - 'null' param: type: - string - 'null' retryHint: enum: - never - after_delay - after_reconnect - reconcile_first - null type: - string - 'null' retryable: type: - boolean - 'null' type: type: - string - 'null' type: - object - 'null' type: object description: Error. The code field is stable; see the error catalog. x-codeSamples: - lang: text label: Reference example source: >- # Fixed reference example. Playground inputs do not update this sample. curl --request POST \ --url https://api.aisa.one/apis/v1/social/tools/validate/post \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data '{ "content": "Our spring collection is live.", "mediaItems": [ { "mediaId": "med_5Tc8Hn2Wq7Lx3Bv9Kd4Fr6", "type": "video" } ], "platforms": [ { "accountId": "acc_7Hq2Lm9Xc4Rt8Vw1Nb6Ks3", "platform": "tiktok", "platformSpecificData": { "privacyLevel": "PUBLIC_TO_EVERYONE" } } ], "profileId": "prf_2Bn8Wq5Td1Yh7Kc3Mz9Lp4", "scheduledFor": "2026-11-20T15:00:00Z", "timezone": "America/New_York" }' components: securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.