Koinelix
EN登录

按次付费 API · X402

让 AI Agent 付得起的 API。

Koinelix 是一个持续扩展的按次付费 API 目录。Agent 自行发现，用 x402 在 Base 上以 USDC 付款并拿到结果。无需注册，无需 API Key。

浏览服务阅读文档
每次调用都是这个流程
  1. POST /v1/…
  2. 402 Payment RequiredPAYMENT-REQUIRED：价格、网络、资产、收款方
  3. 签名报价，重发同一请求PAYMENT-SIGNATURE：<已签名的授权>
  4. 200 OK服务返回的结果

请求流程示意，并非实时调用。

服务

一套付款流程，多个 API

每个服务的调用方式和付款方式都一样。学会一次，所有 API 通用。

图片生成

一次 HTTP 请求，把文字提示词变成图片。

阅读文档 →

更多 API 即将到来

我们正在增加更多按次付费的 API。上线后会出现在这里和发现文档中。

工作方式

从请求到结果，三步完成

  1. 1

    获取报价

    不带付款发送请求。接口返回 402 Payment Required，并在 PAYMENT-REQUIRED 头中给出确切价格和收款方。

  2. 2

    用 x402 付款

    x402 客户端用持有 Base 上 USDC 的钱包签名报价，并带上 PAYMENT-SIGNATURE 头重发请求。付款在服务运行前结算。

  3. 3

    收到结果

    响应携带这次调用的结果。Koinelix 不会索要你的私钥：付款由你自己的客户端签名。

AGENT 接入

让 Agent 自己找到并调用

机器可读的说明文档让 Agent 无需人工介入就能获得接口地址、价格和付款信息。服务开放后由 API 域名提供。

  • 含付款信息的 OpenAPI 3.1https://api.koinelix.com/openapi.json
  • x402 资源列表https://api.koinelix.com/.well-known/x402
  • Markdown 格式的 Agent 指南https://api.koinelix.com/agents.md

把这句话交给你的 Agent

Read https://api.koinelix.com/agents.md and use it to call the Koinelix API.

常见问题

付款前值得了解

什么时候扣款？

每次付款只覆盖一次调用，并在调用运行前结算。之后如果调用失败，不退款，也不会自动重试。每个服务页面会写明自己的规则。

响应丢失了怎么办？

用同一个请求体和同一个 PAYMENT-SIGNATURE 头重发，即可读取原请求的状态，而不必再次付款。没有看到结果之前，不要再次付款。结果是否还能返回，以服务页面的说明为准。

用什么币种和网络付款？

Base 上的 USDC。每份报价都会写明确切的网络、资产、金额和收款方，价格显示在服务卡片上。

一次调用要多久？

取决于具体服务。调用是同步的，请保持连接直到响应返回。每个服务页面会说明预期情况。

你们会看到我的钱包私钥吗？

不会。付款由你自己的客户端签名。Koinelix 不会索要私钥或助记词，无论在本网站还是在 API 中。

有限流吗？

有，按 IP 地址和付款人限流。429 响应带有 Retry-After 头。

可以用账号代替按次付款吗？

可以。注册 Koinelix 账号，生成平台 API Key，作为 Bearer 令牌并配合 Idempotency-Key 使用。基于 Key 的调用额度由 Koinelix 发放，网站暂不出售。一次付款最多允许三次尝试。

账号

更想用账号？

创建 Koinelix 账号，生成平台 API Key，查看调用记录。

创建账号登录