Name: LvyAI Chat API: Cheap OpenAI-Compatible Chat Completion Mode
Brand: lvyapi-1
SKU: api-lvyapi-1-chat-api
Availability: InStock
Author: API Market

figolee


# LvyAI Chat API – OpenAI-Compatible, 70% Cheaper

## Overview

The LvyAI Chat API offers an affordable and fast alternative to OpenAI's chat completion API. It provides access to a variety of large language models (LLMs) including GLM-4, Qwen-Turbo, and DeepSeek-Chat, all accessible through an OpenAI-compatible interface. This allows you to seamlessly integrate LvyAI's cost-effective and low-latency chat completions into your existing projects without significant code changes. Hosted on a Singapore node, this API is optimized for speed, especially for users in the Asia-Pacific region. The pay-as-you-go pricing model allows you to scale your usage without any monthly commitments.

## Features

*   **OpenAI-compatible:**  Drop-in replacement for OpenAI's chat completion API.
*   **Cost-effective:**  70% cheaper than GPT-3.5, significantly reducing your AI development costs.
*   **Multiple Models:** Supports a range of powerful LLMs like GLM-4, Qwen-Turbo, DeepSeek-Chat, Qwen-Plus and more, catering to diverse needs.
*   **Low Latency:** Hosted on a Singapore node for fast response times, especially for users in Asia-Pacific.
*   **Model Selection:** Offers models optimized for general use, coding, Chinese language tasks, and complex reasoning.

## Use Cases

*   **Customer Service Chatbots:**  Build intelligent chatbots for customer support, using models like `qwen-turbo` for cost-effective and fast responses.  Industries: Retail, E-commerce, SaaS.
*   **AI-Powered Coding Assistants:**  Assist developers with code generation, debugging, and documentation, leveraging models like `deepseek-chat` for coding expertise. Industries: Software Development, IT.
*   **Content Generation:**  Generate creative content, write articles, or create marketing copy, leveraging models like `glm-3-turbo` for everyday tasks.  Industries: Marketing, Media, Advertising.
*   **Financial Analysis Tools:** Perform in-depth financial analysis, extract insights from financial reports, and develop predictive models, using the strong reasoning capabilities of `glm-4`. Industries: Finance, Investment Banking.
*   **Educational Applications:** Develop interactive learning platforms, generate quizzes, provide personalized feedback, using a combination of `qwen-turbo` and `deepseek-chat` to suit diverse educational needs. Industries: Education, E-learning.

## Visual Examples

Here's an example of a chat completion request and its response:

**Input:**

```json
{
    "model": "qwen-turbo",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 1,
    "max_tokens": 100,
    "stream": false
}
```

**Output:**

```json
{
  "id": "chatcmpl-7bad2ea6-ebf8-9c69-9148-7086a62cb974",
  "object": "chat.completion",
  "created": 1778074887,
  "model": "qwen-turbo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 11,
    "total_tokens": 24
  }
}
```

## Pricing

We use a multiplier‑based pricing model.

The final cost for a model = **Base Price × Model Multiplier**.

*   **Base Price** is set in your subscription plan (e.g., $0.001 per 1K tokens on the Free/Launcher plan).
*   The table below shows each model's **multiplier**.

| Model ID          | Multiplier | Description                                       |
| :---------------- | :--------- | :------------------------------------------------ |
| `qwen-turbo`      | 0.1        | Fast, low‑cost, recommended for general use       |
| `deepseek-chat`   | 0.5        | Good for coding and logic                          |
| `glm-3-turbo`     | 0.3        | Optimized for Chinese & everyday tasks            |
| `qwen-plus`       | 0.4        | Higher accuracy than turbo                        |
| `deepseek-reasoner` | 1.6        | Step‑by-step reasoning, best for math/analysis    |
| `glm-4`           | 2.5        | Strongest reasoning, for complex instructions    |

> **Example**: If your plan has a base price of $0.001/1K tokens, then calling `qwen-turbo` costs **$0.0001/1K tokens** (70% cheaper than GPT‑3.5), while `glm-4` costs **$0.0025/1K tokens**.
> Exact pricing depends on your chosen subscription plan.

## API Documentation

### Base URL

All API requests should be made to:

```
https://prod.api.market/api/v1/lvyapi-1/chat-api
```

### Authentication

Authentication is handled via API key. Include your API key in the request header:

```
x-api-market-key: YOUR_PERSONAL_API_MARKET_KEY
```

### Endpoints

#### Chat Completion

This endpoint generates a chat completion based on the provided messages and model.

*   **Path:** `/chat/completions`
*   **Method:** POST

**Request Parameters:**

| Field             | Type      | Required | Description                                                      |
| :---------------- | :-------- | :------- | :--------------------------------------------------------------- |
| `model`           | string    | Yes      | One of the supported model IDs: `glm-4`, `glm-3-turbo`, `qwen-turbo`, `qwen-plus`, `deepseek-chat`, `deepseek-reasoner`. |
| `messages`        | array     | Yes      | List of messages with `role` and `content`. **Must contain at least one `user` message.** |
| `temperature`     | float     | No       | Sampling temperature (0–2). Default 1.0                          |
| `max_tokens`      | integer   | No       | Maximum tokens to generate.                                      |
| `top_p`           | float     | No       | Nucleus sampling (0–1). Default 1.0                              |
| `frequency_penalty` | float     | No       | -2.0 to 2.0. Default 0                                           |
| `presence_penalty`  | float     | No       | -2.0 to 2.0. Default 0                                           |
| `stream`          | boolean   | No       | Enable streaming. Default false                                  |

**Example Request:**

```bash
curl -X POST \
  "https://prod.api.market/api/v1/lvyapi-1/chat-api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_PERSONAL_API_MARKET_KEY" \
  -d '{
    "model": "qwen-turbo",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 1,
    "max_tokens": 100
  }'
```

**Example Response (200 OK):**

```json
{
  "id": "chatcmpl-7bad2ea6-ebf8-9c69-9148-7086a62cb974",
  "object": "chat.completion",
  "created": 1778074887,
  "model": "qwen-turbo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I assist you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 11,
    "total_tokens": 24
  }
}
```

## Status Codes

| HTTP Status | Meaning                                  | What to do                                                                    |
| :---------- | :--------------------------------------- | :---------------------------------------------------------------------------- |
| `200`       | OK                                       | Request successful                                                            |
| `401`       | Unauthorized - Invalid API Key           | Make sure you subscribe first and use the correct `x-api-market-key` header. |
| `429`       | Too Many Requests - Quota exceeded     | Upgrade your plan or wait for next billing cycle.                             |
| `400`       | Bad Request - Invalid request parameters | Ensure `messages` contains at least one `user` message and `content` is not empty. Also check your JSON syntax and model name. |
| `500`       | Internal Server Error - Upstream error   | Try again later; contact support if persists.                                |

## Rate Limits

Rate limits are dependent on your subscription plan.  Refer to your API Market dashboard for details.

## Error Handling

The API returns detailed error messages in JSON format to help you diagnose and resolve issues.

**Example Error Response:**

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'model' is required.",
    "status": 400
  }
}
```

**Common Errors and Solutions:**

*   `400 Bad Request`:
    *   `invalid_parameter`:  A required parameter is missing or invalid. Common cause: `messages` array missing a `user` message, or `content` is empty. Check the request parameters against the documentation.
    *   `unsupported_model`: The specified model ID is not supported.  Refer to the list of supported models.
*   `401 Unauthorized`:
    *   `invalid_api_key`: The API key is missing, invalid, or not associated with an active subscription. Verify that you are using the correct API key from your API Market dashboard and that your subscription is active.
*   `429 Too Many Requests`:
    *   `rate_limit_exceeded`:  You have exceeded the rate limit for your current subscription plan.  Upgrade your plan or wait for the rate limit to reset.
*   `500 Internal Server Error`:
    *   `upstream_error`: An error occurred on the server-side.  Try again later.  If the issue persists, contact support.

## Implementation Guide

This section provides guidance on implementing and using the LvyAI Chat API effectively.

### Example Code

Below are code samples demonstrating how to interact with the API using different languages.

```javascript
// JavaScript example
async function callChatCompletion() {
  const apiKey = "YOUR_API_MARKET_KEY";
  const url = "https://prod.api.market/api/v1/lvyapi-1/chat-api/chat/completions";

  const payload = {
    "model": "qwen-turbo",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 1,
    "max_tokens": 100,
    "stream": false
  };

  try {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "x-api-market-key": apiKey
      },
      body: JSON.stringify(payload)
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log(data); // Display the API response
  } catch (error) {
    console.error("Error:", error);
  }
}

callChatCompletion();
```

```python
# Python example
import requests
import json

api_key = "YOUR_API_MARKET_KEY"
url = "https://prod.api.market/api/v1/lvyapi-1/chat-api/chat/completions"

payload = json.dumps({
    "model": "qwen-turbo",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 1,
    "max_tokens": 100,
    "stream": False
})
headers = {
    'Content-Type': 'application/json',
    'x-api-market-key': api_key
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
```

```bash
# cURL example
curl -X POST \
  "https://prod.api.market/api/v1/lvyapi-1/chat-api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "model": "qwen-turbo",
    "messages": [{"role": "user", "content": "Hello"}],
    "temperature": 1,
    "max_tokens": 100,
    "stream": false
  }'
```

### Performance Optimization

*   **Choose the right model:** Select the model that best suits your needs. `qwen-turbo` is a good choice for general-purpose tasks and cost optimization, while `glm-4` is better suited for complex reasoning.
*   **Optimize input tokens:** Minimize the number of tokens in your input messages to reduce costs.
*   **Use streaming:** If you need to display responses in real-time, enable the `stream` parameter.

## FAQ

**Q: What models are supported by the LvyAI Chat API?**
A: The LvyAI Chat API supports `glm-4`, `glm-3-turbo`, `qwen-turbo`, `qwen-plus`, `deepseek-chat`, `deepseek-reasoner`.

**Q: How is pricing calculated?**
A: Pricing is based on a multiplier model. The final cost is calculated as `Base Price × Model Multiplier`, where the base price is defined by your subscription plan.

**Q: How do I handle errors?**
A: The API returns detailed error messages in JSON format. Refer to the Error Handling section of the documentation for more information.

**Q: What is the base URL for the API?**
A: The base URL is `https://prod.api.market/api/v1/lvyapi-1/chat-api`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@api.market.



Access fast, affordable, OpenAI-compatible chat completion models (GLM-4, Qwen-Turbo, DeepSeek) with LvyAI Chat API. Save 70%!