Skip to main content
POST
/
v1
/
products
Create a product
curl --request POST \
  --url https://api.kyren.top/v1/products \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "1000 AI Credits",
  "description": "Top up 1000 credits for AI API usage",
  "price": 9.99,
  "currency": "USD",
  "metadata": {
    "credits": "1000"
  }
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "id": "prod_abc123",
    "name": "1000 AI Credits",
    "description": "Top up 1000 credits for AI API usage",
    "image": null,
    "price": 9.99,
    "currency": "USD",
    "status": "ACTIVE",
    "metadata": {
      "credits": "1000"
    },
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-01-15T10:30:00Z"
  }
}

Authorizations

​
x-api-key
string
header
required

Your API key. Use kyren_live_* for production and kyren_test_* for testing.

Body

application/json
​
name
string
required

The name of the product

Maximum string length: 200
​
price
number
required

The price of the product

Required range: x >= 0.01
​
description
string

A description of the product

Maximum string length: 1000
​
image
string

URL of the product image

​
currency
string
default:CNY

Three-letter ISO currency code (e.g. USD, CNY)

​
metadata
object

Arbitrary key-value pairs for your own use

Response

Product created successfully

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object