> ## 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
# Create Image
>
按用量计费；默认请求预估费用：$0.0143 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。
## 请求规范
* **方法与路径:** POST /apis/v1/htmlcss-to-image/create-image
* **可用状态:** enabled
* **请求 URL 模板:** `https://api.aisa.one/apis/v1/htmlcss-to-image/create-image`
* **Runtime 事实版本:** ecf7b25fc395f7aff68b9e1c0588b3d9a8bb0e613a7bdfd59ede194deb499492
[完整 OpenAPI 定义](https://aisa.one/docs/reference-contracts/zh/htmlcss-to-image.json)
有效请求与价格声明（包括认证和引用的 schema）：
```json theme={null}
{
"operationId": "htmlcss-to-image.create-image",
"method": "POST",
"path": "/apis/v1/htmlcss-to-image/create-image",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"css": {
"type": "string",
"examples": [
".card { padding: 24px; }"
],
"description": "CSS applied to supplied HTML or injected into a captured webpage."
},
"url": {
"type": "string",
"examples": [
"https://example.com"
],
"description": "Absolute, internet-reachable HTTP(S) webpage URL to capture. Set this or html, but not both; use headers for authenticated pages."
},
"html": {
"minLength": 1,
"type": "string",
"description": "HTML to render. Set this or url, but not both.",
"examples": [
"Hello
"
]
},
"headers": {
"type": "object",
"examples": [
{
"X-Preview-Mode": "true"
}
],
"description": "HTTP headers sent to the captured page, with at most 20 case-insensitive names.",
"maxProperties": 20,
"additionalProperties": {
"type": "string"
}
},
"ms_delay": {
"maximum": 10000,
"minimum": 1,
"type": "integer",
"description": "Extra render delay in milliseconds, from 0 to 10000. Zero omits the explicit delay."
},
"selector": {
"type": "string",
"examples": [
"#invoice"
],
"description": "CSS selector for the element to capture."
},
"timezone": {
"type": "string",
"examples": [
"America/New_York"
],
"description": "IANA timezone exposed to the rendered page."
},
"media_type": {
"enum": [
"screen"
],
"type": "string",
"description": "CSS media type used while rendering: screen or print."
},
"full_screen": {
"type": "boolean",
"default": false,
"description": "Capture the full scrollable page instead of only the viewport."
},
"max_wait_ms": {
"type": "integer",
"maximum": 10000,
"minimum": 500,
"description": "Maximum wait from 500 to 10000 milliseconds for page loading."
},
"color_scheme": {
"enum": [
"light",
"dark"
],
"type": "string",
"description": "Preferred browser color scheme: light or dark."
},
"device_scale": {
"type": "number",
"default": 2,
"maximum": 3,
"minimum": 0.1,
"description": "Device scale factor from 0.1 to 3."
},
"google_fonts": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
[
"Inter",
"Roboto"
]
],
"description": "Google Font family names to load while rendering."
},
"viewport_width": {
"type": "integer",
"maximum": 6000,
"minimum": 1,
"description": "Viewport width in pixels, from 1 to 6000. Requires viewport_height."
},
"viewport_height": {
"type": "integer",
"minimum": 1,
"description": "Viewport height in pixels. Requires viewport_width."
},
"dedupe_duration_s": {
"type": "integer",
"minimum": 0,
"description": "Reuse a matching recent render for this many seconds. Allowed durations depend on the account plan; free accounts accept 0 or 2592000 (30 days)."
},
"render_when_ready": {
"enum": [
false
],
"type": "boolean",
"description": "Wait until the page signals that rendering is ready."
},
"block_consent_banners": {
"type": "boolean",
"default": false,
"description": "Attempt to block common consent banners."
},
"transparent_background": {
"type": "boolean",
"default": false,
"description": "Render a transparent background where supported."
},
"additional_header_origins": {
"type": "array",
"items": {
"type": "string"
},
"examples": [
[
"https://assets.example.com"
]
],
"maxItems": 20,
"description": "Up to 20 unique exact HTTP(S) origins that may also receive headers."
},
"include_headers_on_subrequests": {
"type": "boolean",
"default": false,
"description": "Also include supplied headers on page subrequests."
}
},
"required": [
"html",
"media_type",
"ms_delay",
"render_when_ready"
]
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_units",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.0143,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 10000000,
"unit": "provider_credit",
"unit_rate_usd": 1e-06
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
```
## 费用与请求规则
按用量计费；默认请求预估费用：\$0.0143 USD（不是固定价格）。 声明的单位费率：每 provider\_credit \$0.000001 USD。 最终费用以账户适用价格及实际结算为准。
公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
* **默认请求参考估价（USD）:** 0.0143
* **声明的单位费率（USD）:** 1e-06
* **计费单位:** provider\_credit
* **计费依据:** response\_units
* **公开参考倍率:** 1.0
* **声明的最大计数或单位数:** 10000000
* **结算证据来源:** response\_body
## OpenAPI
````yaml reference-contracts/zh/htmlcss-to-image.json POST /apis/v1/htmlcss-to-image/create-image
openapi: 3.1.0
info:
description: ''
title: HTML/CSS to Image
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:
- /apis/v1/htmlcss-to-image/create-image
- /apis/v1/htmlcss-to-image/create-images-batch
x-aisa-document:
facts_hash: ecf7b25fc395f7aff68b9e1c0588b3d9a8bb0e613a7bdfd59ede194deb499492
generator_version: '3'
protocol_version: '1'
schema_version: '1'
composer_version: '28'
response_pending: []
document_hash: sha256:2345b9a4b0360f4708298cc9f492b8884ce2f764ab162d699e028d60ad7535de
x-aisa-plans:
builder: 1
display_plan: payg
payg: 1
similarweb_payg: 1
team: 1
version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
x-aisa-provider: htmlcss-to-image
x-aisa-catalogs:
htmlcss-to-image:
title: HTML/CSS to Image
description: ''
x-aisa-document:
facts_hash: ecf7b25fc395f7aff68b9e1c0588b3d9a8bb0e613a7bdfd59ede194deb499492
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/htmlcss-to-image/create-image:
post:
tags:
- HTML/CSS to Image
summary: Create Image
description: >-
按用量计费；默认请求预估费用：$0.0143 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001
USD。 最终费用以账户适用价格及实际结算为准。
operationId: htmlcss-to-image.create-image
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
css:
type: string
examples:
- '.card { padding: 24px; }'
description: >-
CSS applied to supplied HTML or injected into a captured
webpage.
url:
type: string
examples:
- https://example.com
description: >-
Absolute, internet-reachable HTTP(S) webpage URL to capture.
Set this or html, but not both; use headers for
authenticated pages.
html:
type: string
examples:
- Hello
minLength: 1
description: HTML to render. Set this or url, but not both.
headers:
type: object
examples:
- X-Preview-Mode: 'true'
description: >-
HTTP headers sent to the captured page, with at most 20
case-insensitive names.
maxProperties: 20
additionalProperties:
type: string
ms_delay:
maximum: 10000
minimum: 1
type: integer
description: >-
Extra render delay in milliseconds, from 0 to 10000. Zero
omits the explicit delay.
selector:
type: string
examples:
- '#invoice'
description: CSS selector for the element to capture.
timezone:
type: string
examples:
- America/New_York
description: IANA timezone exposed to the rendered page.
media_type:
enum:
- screen
type: string
description: 'CSS media type used while rendering: screen or print.'
full_screen:
type: boolean
default: false
description: >-
Capture the full scrollable page instead of only the
viewport.
max_wait_ms:
type: integer
maximum: 10000
minimum: 500
description: >-
Maximum wait from 500 to 10000 milliseconds for page
loading.
color_scheme:
enum:
- light
- dark
type: string
description: 'Preferred browser color scheme: light or dark.'
device_scale:
type: number
default: 2
maximum: 3
minimum: 0.1
description: Device scale factor from 0.1 to 3.
google_fonts:
type: array
items:
type: string
examples:
- - Inter
- Roboto
description: Google Font family names to load while rendering.
viewport_width:
type: integer
maximum: 6000
minimum: 1
description: >-
Viewport width in pixels, from 1 to 6000. Requires
viewport_height.
viewport_height:
type: integer
minimum: 1
description: Viewport height in pixels. Requires viewport_width.
dedupe_duration_s:
type: integer
minimum: 0
description: >-
Reuse a matching recent render for this many seconds.
Allowed durations depend on the account plan; free accounts
accept 0 or 2592000 (30 days).
render_when_ready:
enum:
- false
type: boolean
description: Wait until the page signals that rendering is ready.
block_consent_banners:
type: boolean
default: false
description: Attempt to block common consent banners.
transparent_background:
type: boolean
default: false
description: Render a transparent background where supported.
additional_header_origins:
type: array
items:
type: string
examples:
- - https://assets.example.com
maxItems: 20
description: >-
Up to 20 unique exact HTTP(S) origins that may also receive
headers.
include_headers_on_subrequests:
type: boolean
default: false
description: Also include supplied headers on page subrequests.
required:
- html
- media_type
- ms_delay
- render_when_ready
responses:
'200':
description: Tool result data
content:
application/json:
schema:
$ref: >-
#/components/schemas/Response576A0Ea506F3_connect_HTMLCSS_TO_IMAGE_CREATE_IMAGE__output__public_data
default:
content:
application/json:
schema: {}
description: >-
Error response; upstream passthrough responses may use provider
formats
components:
schemas:
Response576A0Ea506F3_connect_HTMLCSS_TO_IMAGE_CREATE_IMAGE__output__public_data:
$ref: >-
#/components/schemas/Response576A0Ea506F3_connect_HTMLCSS_TO_IMAGE_CREATE_IMAGE__output__364bfc33cfed7820
Response576A0Ea506F3_connect_HTMLCSS_TO_IMAGE_CREATE_IMAGE__output__364bfc33cfed7820:
type: object
required:
- id
- url
properties:
id:
type: string
url:
type: string
securitySchemes:
bearerAuth:
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.