Ryzenth

Name	Ryzenth JSON
Version	2.2.7 JSON
	download
home_page	None
Summary	Ryzenth is a flexible Multi-API SDK with built-in support for API key management and database integration.
upload_time	2025-08-15 13:37:31
maintainer	None
docs_url	None
author	TeamKillerX
requires_python	~=3.7
license	MIT
keywords	multi-api ryzenth-sdk ryzenth
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Ryzenth Library

[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.png?v=103)](https://github.com/TeamKillerX/Ryzenth)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-Yes-green)](https://github.com/TeamKillerX/Ryzenth/graphs/commit-activity)
[![License](https://img.shields.io/badge/License-MIT-pink)](https://github.com/TeamKillerX/Ryzenth/blob/dev/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
[![Ryzenth - Version](https://img.shields.io/pypi/v/Ryzenth?style=round)](https://pypi.org/project/Ryzenth)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/TeamKillerX/Ryzenth/dev.svg)](https://results.pre-commit.ci/latest/github/TeamKillerX/Ryzenth/dev)

<div align="center">
    <a href="https://pepy.tech/project/Ryzenth"><img src="https://static.pepy.tech/badge/Ryzenth" alt="Downloads"></a>
    <a href="https://github.com/TeamKillerX/Ryzenth/workflows/"><img src="https://github.com/TeamKillerX/Ryzenth/actions/workflows/async-tests.yml/badge.svg" alt="API Tests"/></a>
</div>

---

![Image](https://github.com/user-attachments/assets/ebb42582-4d5d-4f6a-8e8b-78d737810510)

---

**Ryzenth** is a powerful Multi-API SDK designed to seamlessly handle API keys and database connections with ease.

It provides native support for both **synchronous and asynchronous** operations, making it ideal for modern applications including AI APIs, Telegram bots, REST services, and automation tools.

Built with `httpx` and `aiohttp` integration, comprehensive logging features (including Telegram alerts), and database storage capabilities like MongoDB, Ryzenth empowers developers with a flexible, scalable, and customizable API client solution.

## 🚨 Important Notes

### HTTP 403 Error Fix
If you're encountering **403 Forbidden** errors, ensure you're setting proper headers:

```python
# ✅ CORRECT - Always use proper headers
from Ryzenth import RyzenthApiClient

clients = RyzenthApiClient(
    tools_name=["your-tool"],
    api_key={"your-tool": [{"Authorization": "Bearer your-token"}]},
    rate_limit=100,
    use_default_headers=True  # 🔥 IMPORTANT: Set this to True
)

# ✅ CORRECT - Custom headers example
clients = RyzenthApiClient(
    tools_name=["your-tool"],
    api_key={"your-tool": [{
        "Authorization": "Bearer your-token",
        "Accept": "application/json",
        "Content-Type": "application/json"
    }]},
    rate_limit=100,
    use_default_headers=True
)

# ❌ WRONG - Missing headers will cause 403 errors
clients = RyzenthApiClient(
    tools_name=["your-tool"],
    api_key={"your-tool": [{}]},  # Empty headers
    use_default_headers=False     # No default headers
)
```

### Required Headers Format
The library automatically adds these headers when `use_default_headers=True`:
- `User-Agent: Ryzenth/Python v-{version}`
- `Accept: application/json`
- `Content-Type: application/json`

### Javascript Your own API
```js
const ua = req.headers['User-Agent'];
const gh = req.headers['X-Github-Source'];
const ghVersion = req.headers['X-Ryzenth-Version'];

console.log(gh) // check valid whitelist TeamKillerX/Ryzenth
```

## ✨ Features

- 🔄 **Dual Mode Support**: Works with both `sync` and `async` clients
- 🔐 **Smart API Key Management**: Built-in API key handling and rotation
- 🤖 **AI-Ready**: Seamless integration with modern AI services (image generation, text processing, etc.)
- ⚡ **High Performance**: Built on `httpx` for optimal speed and reliability
- 📊 **Comprehensive Logging**: Built-in logging with optional Telegram notifications
- 🛡️ **Error Handling**: Robust error handling with automatic retries
- 🎯 **Context Managers**: Proper resource management with async context support
- 📦 **Database Integration**: MongoDB and other database connectors included

## 📦 Installation

### Standard Installation
```bash
pip3 install ryzenth[fast]
```

### Development Installation (Latest Features)
```bash
pip3 install git+https://github.com/TeamKillerX/Ryzenth.git
```

## 🚀 Quick Start

### 🔗 New Chaining API Support
Modern fluent API with method chaining:

```python
from Ryzenth import RyzenthAuthClient

# 🌟 Fluent API with chaining
response = await RyzenthAuthClient()\
    .with_credentials("68750d3b92828xxxxxxxx", "sk-ryzenth-*")\
    .use_tool("instatiktok")\
    .set_parameter("&url={url}&platform=facebook")\
    .retry(2)\
    .cache(True)\
    .timeout(10)\
    .execute()

print(response)

# 🔧 Traditional client approach
clients = await RyzenthApiClient(
    tools_name=["ryzenth-v2"],
    api_key={"ryzenth-v2": [{}]},
    rate_limit=100,
    use_default_headers=True
)
```

### 🤖 AI Features (No API Key Required)
Supports multiple AI models: `grok`, `deepseek-reasoning`, `evil`, `unity`, `sur`, `rtist`, `hypnosis-tracy`, `llama-roblox`

```python
from Ryzenth import RyzenthTools

rt = RyzenthTools()

# 💬 Chat Ultimate - Multiple AI Models
response_grok = await rt.aio.chat.ask_ultimate(
    "What is Durov's role in Telegram?",
    model="grok"
)
print(await response_grok.to_result())

# 🎯 OpenAI V2 Integration
response_openai = await rt.aio.chat.ask("What's the capital of Japan?")
print(await response_openai.to_result())

# 🎨 Image Generation
response_content = await rt.aio.images.create("generate a blue cat")
await response_content.to_save()

# 👀 Image Analysis with Upload
response_see = await rt.aio.images.create_upload_to_ask(
    "Describe this image:",
    "/path/to/example.jpg"
)
result = await response_see.to_result()

# 🧹 Proper cleanup
await rt.aio.chat.close()
await rt.aio_client.images.close()
```

### 🎥 Advanced AI Features

```python
# 🖼️ Multiple image operations
await rt.aio.images.create()
await rt.aio.images.create_gemini_and_captions()
await rt.aio_client.images.create_gemini_to_edit(
    "add Lamborghini background",
    "/path/to/example.jpg"
)  # Use response.to_buffer_and_list()

await rt.aio.images.create_upload_to_ask()
await rt.aio.images.create_multiple()

# 💭 Chat operations
await rt.aio.chat.ask()
await rt.aio.chat.ask_ultimate()
```

---

## 🎬 Image & Video Generation with Qwen AI

Generate high-quality images and videos using **Qwen AI** with dot notation access:

```python
from Ryzenth import RyzenthTools

rt = RyzenthTools("your-qwen-api-key")

# 🖼️ Generate Image
response = await rt.aio.qwen_images.create("generate a blue cat running")
output = await response.create_task_and_wait(max_retries=120, poll_interval=1.0)

print("🎨 Image URL:", output.results[0].url)

# 🎬 Generate Video
response_video = await rt.aio.qwen_videos.create("blue cat running in slow motion")
output_video = await response_video.create_task_and_wait(max_retries=120, poll_interval=1.0)

print("🎥 Video URL:", output_video.video_url)
```

> **⚠️ Version Note**: Dot notation access may be limited in version `2.2.3+` due to API changes. Check our [GitHub Discussions](https://github.com/TeamKillerX/Ryzenth/discussions) for updates.

---

## 🛠️ Developer Tools & Supported APIs

### Available API Tools
Choose from our extensive list of supported APIs:

| Tool Name | Status | Description |
|-----------|--------|-------------|
| `itzpire` | ❌ Dead | Legacy API service |
| `ryzenth` | ✅ Active | Main Ryzenth API |
| `ryzenth-v2` | ✅ Active | Enhanced Ryzenth API |
| `siputzx` | ✅ Active (Auto block) | Community API |
| `fgsi` | ✅ Active | FGSI API Service |
| `onrender` | ✅ Active | Render-based API |
| `deepseek` | ✅ Active | DeepSeek AI API |
| `cloudflare` | ✅ Active | Cloudflare Workers API |
| `paxsenix` | ✅ Active | PaxSenix API |
| `exonity` | ✅ Active | Exonity API |
| `yogik` | ❌ Dead | Legacy API |
| `ytdlpyton` | ✅ Active | YouTube downloader |
| `openai` | ✅ Active | OpenAI API |
| `cohere` | ✅ Active | Cohere AI API |
| `claude` | ✅ Active | Anthropic Claude API |
| `grok` | ✅ Active | Grok AI API |
| `alibaba` | ✅ Active | Alibaba Qwen API |
| `gemini` | ✅ Active | Google Gemini API |
| `gemini-openai` | ✅ Active | Gemini OpenAI Compatible |

### 🔧 Custom API Implementation

```python
from Ryzenth import RyzenthApiClient

# 🎯 Example with SiputZX API
clients = RyzenthApiClient(
    tools_name=["siputzx"],
    api_key={"siputzx": [{"Authorization": "Bearer test"}]},
    rate_limit=100,
    use_default_headers=True  # 🔥 Always enable for 403 fix
)

# Your implementation logic here
response = await clients.get(
    tool="siputzx",
    path="/api/endpoint",
    params={"query": "your-query"}
)
```

> **📚 Resources**:
> - Example plugins: [`/dev/modules/paxsenix.py`](https://github.com/TeamKillerX/Ryzenth/blob/dev/modules/paxsenix.py)
> - Shared domains: [`/Ryzenth/_shared.py#L4`](https://github.com/TeamKillerX/Ryzenth/blob/83ea891711c89d3c53e646c866ee5137f81fcb4c/Ryzenth/_shared.py#L4)

---

## 🏗️ Legacy Examples (Deprecated)

### Async Example
```python
from Ryzenth import ApiKeyFrom
from Ryzenth.types import QueryParameter

ryz = ApiKeyFrom(..., is_ok=True)

await ryz.aio.send_message(
    "hybrid",
    QueryParameter(query="hello world!")
)
```

### Sync Example
```python
from Ryzenth import ApiKeyFrom
from Ryzenth.types import QueryParameter

ryz = ApiKeyFrom(..., is_ok=True)
ryz._sync.send_message(
    "hybrid",
    QueryParameter(query="hello world!")
)
```

---

## 🤖 Multi-Platform AI Support

### Grok AI Integration
```python
from Ryzenth.tool import GrokClient

g = GrokClient(api_key="sk-grok-xxxx")

response = await g.chat_completions(
    messages=[
        {
            "role": "system",
            "content": "You are Grok, a chatbot inspired by the Hitchhiker's Guide to the Galaxy."
        },
        {
            "role": "user",
            "content": "What is the meaning of life, the universe, and everything?"
        }
    ],
    model="grok-3-mini-latest",
    reasoning_effort="low",
    temperature=0.7,
    timeout=30
)
print(response)
```

---

## 🔑 API Keys & Documentation

### 🤖 AI Platform Documentation
- **OpenAI**: [Platform Documentation](https://platform.openai.com/docs)
- **Google Gemini**: [AI Development Guide](https://ai.google.dev)
- **Cohere**: [API Documentation](https://docs.cohere.com/)
- **Alibaba Qwen**: [Model Studio Guide](https://www.alibabacloud.com/help/en/model-studio/use-qwen-by-calling-api)
- **Anthropic Claude**: [API Reference](https://docs.anthropic.com/)
- **Grok AI**: [X.AI Documentation](https://docs.x.ai/docs)

### 🔐 Get Your API Keys
| Platform | Get API Key | Official Website |
|----------|-------------|------------------|
| **Ryzenth** | [Get Key](https://ryzenths.dpdns.org) | Official Ryzenth Portal |
| **OpenAI** | [Get Key](https://platform.openai.com/api-keys) | OpenAI Platform |
| **Cohere** | [Get Key](https://dashboard.cohere.com/api-keys) | Cohere Dashboard |
| **Alibaba** | [Get Key](https://bailian.console.alibabacloud.com/?tab=playground#/api-key) | Alibaba Console |
| **Claude** | [Get Key](https://console.anthropic.com/settings/keys) | Anthropic Console |
| **Grok** | [Get Key](https://console.x.ai/team/default/api-keys) | X.AI Console |

---

## 🏆 Credits & Contributors

### 🌐 API Provider Partners
- **[PaxSenix](https://api.paxsenix.biz.id)** - PaxSenix Development Team
- **[Itzpire](https://itzpire.com)** - Itzpire Development Team
- **[Ytdlpyton](https://ytdlpyton.nvlgroup.my.id/)** - Unesa Development Team
- **[Exonity](https://exonity.tech)** - Exonity Development Team
- **[Yogik](https://api.yogik.id)** - Yogik Team (Legacy)
- **[Siputzx](https://api.siputzx.my.id)** - Siputzx Development Team
- **[FGSI](https://fgsi.koyeb.app)** - FGSI Development Team
- **[X-API-JS](https://x-api-js.onrender.com/docs)** - Ryzenth DLR JavaScript Team
- **[Ryzenth V2](https://ryzenths.dpdns.org)** - Ryzenth TypeScript Team

### 🙏 Special Thanks
- **[xtdevs](https://t.me/xtdevs)** - Lead Developer & Creator
- **TeamKillerX** - Core Development Team
- **AkenoX Project** - Original inspiration and foundation
- **Google Developer Tools** - AI integration support
- **Open Source Community** - Contributions and feedback

---

## 💖 Support Development

Your support helps us continue building and maintaining this project!

### 💰 Donation Options
- **Bank Transfer (DANA)**: Send to Bank Jago `100201327349`
- **Cryptocurrency**: Contact us for wallet addresses
- **GitHub Sponsors**: [Sponsor on GitHub](https://github.com/sponsors/TeamKillerX)

Every contribution, no matter the size, makes a difference! 🚀

---

## 📄 License

**MIT License © 2025 Ryzenth Developers from TeamKillerX**

This project is open source and available under the [MIT License](https://github.com/TeamKillerX/Ryzenth/blob/dev/LICENSE).

---

<div align="center">

### 🌟 Star us on GitHub if you find this project useful!

[![GitHub stars](https://img.shields.io/github/stars/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth)
[![GitHub forks](https://img.shields.io/github/forks/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth/fork)
[![GitHub watchers](https://img.shields.io/github/watchers/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth)

**Made with ❤️ by the Ryzenth Team**

</div>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "Ryzenth",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "~=3.7",
    "maintainer_email": null,
    "keywords": "Multi-API, Ryzenth-SDK, Ryzenth",
    "author": "TeamKillerX",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/65/3a/84924e5b2debce1f0e0220042ac62fd81ea7cef13e40b089938f1818390a/ryzenth-2.2.7.tar.gz",
    "platform": null,
    "description": "# Ryzenth Library\n\n[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.png?v=103)](https://github.com/TeamKillerX/Ryzenth)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-Yes-green)](https://github.com/TeamKillerX/Ryzenth/graphs/commit-activity)\n[![License](https://img.shields.io/badge/License-MIT-pink)](https://github.com/TeamKillerX/Ryzenth/blob/dev/LICENSE)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)\n[![Ryzenth - Version](https://img.shields.io/pypi/v/Ryzenth?style=round)](https://pypi.org/project/Ryzenth)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/TeamKillerX/Ryzenth/dev.svg)](https://results.pre-commit.ci/latest/github/TeamKillerX/Ryzenth/dev)\n\n<div align=\"center\">\n    <a href=\"https://pepy.tech/project/Ryzenth\"><img src=\"https://static.pepy.tech/badge/Ryzenth\" alt=\"Downloads\"></a>\n    <a href=\"https://github.com/TeamKillerX/Ryzenth/workflows/\"><img src=\"https://github.com/TeamKillerX/Ryzenth/actions/workflows/async-tests.yml/badge.svg\" alt=\"API Tests\"/></a>\n</div>\n\n---\n\n![Image](https://github.com/user-attachments/assets/ebb42582-4d5d-4f6a-8e8b-78d737810510)\n\n---\n\n**Ryzenth** is a powerful Multi-API SDK designed to seamlessly handle API keys and database connections with ease.\n\nIt provides native support for both **synchronous and asynchronous** operations, making it ideal for modern applications including AI APIs, Telegram bots, REST services, and automation tools.\n\nBuilt with `httpx` and `aiohttp` integration, comprehensive logging features (including Telegram alerts), and database storage capabilities like MongoDB, Ryzenth empowers developers with a flexible, scalable, and customizable API client solution.\n\n## \ud83d\udea8 Important Notes\n\n### HTTP 403 Error Fix\nIf you're encountering **403 Forbidden** errors, ensure you're setting proper headers:\n\n```python\n# \u2705 CORRECT - Always use proper headers\nfrom Ryzenth import RyzenthApiClient\n\nclients = RyzenthApiClient(\n    tools_name=[\"your-tool\"],\n    api_key={\"your-tool\": [{\"Authorization\": \"Bearer your-token\"}]},\n    rate_limit=100,\n    use_default_headers=True  # \ud83d\udd25 IMPORTANT: Set this to True\n)\n\n# \u2705 CORRECT - Custom headers example\nclients = RyzenthApiClient(\n    tools_name=[\"your-tool\"],\n    api_key={\"your-tool\": [{\n        \"Authorization\": \"Bearer your-token\",\n        \"Accept\": \"application/json\",\n        \"Content-Type\": \"application/json\"\n    }]},\n    rate_limit=100,\n    use_default_headers=True\n)\n\n# \u274c WRONG - Missing headers will cause 403 errors\nclients = RyzenthApiClient(\n    tools_name=[\"your-tool\"],\n    api_key={\"your-tool\": [{}]},  # Empty headers\n    use_default_headers=False     # No default headers\n)\n```\n\n### Required Headers Format\nThe library automatically adds these headers when `use_default_headers=True`:\n- `User-Agent: Ryzenth/Python v-{version}`\n- `Accept: application/json`\n- `Content-Type: application/json`\n\n### Javascript Your own API\n```js\nconst ua = req.headers['User-Agent'];\nconst gh = req.headers['X-Github-Source'];\nconst ghVersion = req.headers['X-Ryzenth-Version'];\n\nconsole.log(gh) // check valid whitelist TeamKillerX/Ryzenth\n```\n\n## \u2728 Features\n\n- \ud83d\udd04 **Dual Mode Support**: Works with both `sync` and `async` clients\n- \ud83d\udd10 **Smart API Key Management**: Built-in API key handling and rotation\n- \ud83e\udd16 **AI-Ready**: Seamless integration with modern AI services (image generation, text processing, etc.)\n- \u26a1 **High Performance**: Built on `httpx` for optimal speed and reliability\n- \ud83d\udcca **Comprehensive Logging**: Built-in logging with optional Telegram notifications\n- \ud83d\udee1\ufe0f **Error Handling**: Robust error handling with automatic retries\n- \ud83c\udfaf **Context Managers**: Proper resource management with async context support\n- \ud83d\udce6 **Database Integration**: MongoDB and other database connectors included\n\n## \ud83d\udce6 Installation\n\n### Standard Installation\n```bash\npip3 install ryzenth[fast]\n```\n\n### Development Installation (Latest Features)\n```bash\npip3 install git+https://github.com/TeamKillerX/Ryzenth.git\n```\n\n## \ud83d\ude80 Quick Start\n\n### \ud83d\udd17 New Chaining API Support\nModern fluent API with method chaining:\n\n```python\nfrom Ryzenth import RyzenthAuthClient\n\n# \ud83c\udf1f Fluent API with chaining\nresponse = await RyzenthAuthClient()\\\n    .with_credentials(\"68750d3b92828xxxxxxxx\", \"sk-ryzenth-*\")\\\n    .use_tool(\"instatiktok\")\\\n    .set_parameter(\"&url={url}&platform=facebook\")\\\n    .retry(2)\\\n    .cache(True)\\\n    .timeout(10)\\\n    .execute()\n\nprint(response)\n\n# \ud83d\udd27 Traditional client approach\nclients = await RyzenthApiClient(\n    tools_name=[\"ryzenth-v2\"],\n    api_key={\"ryzenth-v2\": [{}]},\n    rate_limit=100,\n    use_default_headers=True\n)\n```\n\n### \ud83e\udd16 AI Features (No API Key Required)\nSupports multiple AI models: `grok`, `deepseek-reasoning`, `evil`, `unity`, `sur`, `rtist`, `hypnosis-tracy`, `llama-roblox`\n\n```python\nfrom Ryzenth import RyzenthTools\n\nrt = RyzenthTools()\n\n# \ud83d\udcac Chat Ultimate - Multiple AI Models\nresponse_grok = await rt.aio.chat.ask_ultimate(\n    \"What is Durov's role in Telegram?\",\n    model=\"grok\"\n)\nprint(await response_grok.to_result())\n\n# \ud83c\udfaf OpenAI V2 Integration\nresponse_openai = await rt.aio.chat.ask(\"What's the capital of Japan?\")\nprint(await response_openai.to_result())\n\n# \ud83c\udfa8 Image Generation\nresponse_content = await rt.aio.images.create(\"generate a blue cat\")\nawait response_content.to_save()\n\n# \ud83d\udc40 Image Analysis with Upload\nresponse_see = await rt.aio.images.create_upload_to_ask(\n    \"Describe this image:\",\n    \"/path/to/example.jpg\"\n)\nresult = await response_see.to_result()\n\n# \ud83e\uddf9 Proper cleanup\nawait rt.aio.chat.close()\nawait rt.aio_client.images.close()\n```\n\n### \ud83c\udfa5 Advanced AI Features\n\n```python\n# \ud83d\uddbc\ufe0f Multiple image operations\nawait rt.aio.images.create()\nawait rt.aio.images.create_gemini_and_captions()\nawait rt.aio_client.images.create_gemini_to_edit(\n    \"add Lamborghini background\",\n    \"/path/to/example.jpg\"\n)  # Use response.to_buffer_and_list()\n\nawait rt.aio.images.create_upload_to_ask()\nawait rt.aio.images.create_multiple()\n\n# \ud83d\udcad Chat operations\nawait rt.aio.chat.ask()\nawait rt.aio.chat.ask_ultimate()\n```\n\n---\n\n## \ud83c\udfac Image & Video Generation with Qwen AI\n\nGenerate high-quality images and videos using **Qwen AI** with dot notation access:\n\n```python\nfrom Ryzenth import RyzenthTools\n\nrt = RyzenthTools(\"your-qwen-api-key\")\n\n# \ud83d\uddbc\ufe0f Generate Image\nresponse = await rt.aio.qwen_images.create(\"generate a blue cat running\")\noutput = await response.create_task_and_wait(max_retries=120, poll_interval=1.0)\n\nprint(\"\ud83c\udfa8 Image URL:\", output.results[0].url)\n\n# \ud83c\udfac Generate Video\nresponse_video = await rt.aio.qwen_videos.create(\"blue cat running in slow motion\")\noutput_video = await response_video.create_task_and_wait(max_retries=120, poll_interval=1.0)\n\nprint(\"\ud83c\udfa5 Video URL:\", output_video.video_url)\n```\n\n> **\u26a0\ufe0f Version Note**: Dot notation access may be limited in version `2.2.3+` due to API changes. Check our [GitHub Discussions](https://github.com/TeamKillerX/Ryzenth/discussions) for updates.\n\n---\n\n## \ud83d\udee0\ufe0f Developer Tools & Supported APIs\n\n### Available API Tools\nChoose from our extensive list of supported APIs:\n\n| Tool Name | Status | Description |\n|-----------|--------|-------------|\n| `itzpire` | \u274c Dead | Legacy API service |\n| `ryzenth` | \u2705 Active | Main Ryzenth API |\n| `ryzenth-v2` | \u2705 Active | Enhanced Ryzenth API |\n| `siputzx` | \u2705 Active (Auto block) | Community API |\n| `fgsi` | \u2705 Active | FGSI API Service |\n| `onrender` | \u2705 Active | Render-based API |\n| `deepseek` | \u2705 Active | DeepSeek AI API |\n| `cloudflare` | \u2705 Active | Cloudflare Workers API |\n| `paxsenix` | \u2705 Active | PaxSenix API |\n| `exonity` | \u2705 Active | Exonity API |\n| `yogik` | \u274c Dead | Legacy API |\n| `ytdlpyton` | \u2705 Active | YouTube downloader |\n| `openai` | \u2705 Active | OpenAI API |\n| `cohere` | \u2705 Active | Cohere AI API |\n| `claude` | \u2705 Active | Anthropic Claude API |\n| `grok` | \u2705 Active | Grok AI API |\n| `alibaba` | \u2705 Active | Alibaba Qwen API |\n| `gemini` | \u2705 Active | Google Gemini API |\n| `gemini-openai` | \u2705 Active | Gemini OpenAI Compatible |\n\n### \ud83d\udd27 Custom API Implementation\n\n```python\nfrom Ryzenth import RyzenthApiClient\n\n# \ud83c\udfaf Example with SiputZX API\nclients = RyzenthApiClient(\n    tools_name=[\"siputzx\"],\n    api_key={\"siputzx\": [{\"Authorization\": \"Bearer test\"}]},\n    rate_limit=100,\n    use_default_headers=True  # \ud83d\udd25 Always enable for 403 fix\n)\n\n# Your implementation logic here\nresponse = await clients.get(\n    tool=\"siputzx\",\n    path=\"/api/endpoint\",\n    params={\"query\": \"your-query\"}\n)\n```\n\n> **\ud83d\udcda Resources**:\n> - Example plugins: [`/dev/modules/paxsenix.py`](https://github.com/TeamKillerX/Ryzenth/blob/dev/modules/paxsenix.py)\n> - Shared domains: [`/Ryzenth/_shared.py#L4`](https://github.com/TeamKillerX/Ryzenth/blob/83ea891711c89d3c53e646c866ee5137f81fcb4c/Ryzenth/_shared.py#L4)\n\n---\n\n## \ud83c\udfd7\ufe0f Legacy Examples (Deprecated)\n\n### Async Example\n```python\nfrom Ryzenth import ApiKeyFrom\nfrom Ryzenth.types import QueryParameter\n\nryz = ApiKeyFrom(..., is_ok=True)\n\nawait ryz.aio.send_message(\n    \"hybrid\",\n    QueryParameter(query=\"hello world!\")\n)\n```\n\n### Sync Example\n```python\nfrom Ryzenth import ApiKeyFrom\nfrom Ryzenth.types import QueryParameter\n\nryz = ApiKeyFrom(..., is_ok=True)\nryz._sync.send_message(\n    \"hybrid\",\n    QueryParameter(query=\"hello world!\")\n)\n```\n\n---\n\n## \ud83e\udd16 Multi-Platform AI Support\n\n### Grok AI Integration\n```python\nfrom Ryzenth.tool import GrokClient\n\ng = GrokClient(api_key=\"sk-grok-xxxx\")\n\nresponse = await g.chat_completions(\n    messages=[\n        {\n            \"role\": \"system\",\n            \"content\": \"You are Grok, a chatbot inspired by the Hitchhiker's Guide to the Galaxy.\"\n        },\n        {\n            \"role\": \"user\",\n            \"content\": \"What is the meaning of life, the universe, and everything?\"\n        }\n    ],\n    model=\"grok-3-mini-latest\",\n    reasoning_effort=\"low\",\n    temperature=0.7,\n    timeout=30\n)\nprint(response)\n```\n\n---\n\n## \ud83d\udd11 API Keys & Documentation\n\n### \ud83e\udd16 AI Platform Documentation\n- **OpenAI**: [Platform Documentation](https://platform.openai.com/docs)\n- **Google Gemini**: [AI Development Guide](https://ai.google.dev)\n- **Cohere**: [API Documentation](https://docs.cohere.com/)\n- **Alibaba Qwen**: [Model Studio Guide](https://www.alibabacloud.com/help/en/model-studio/use-qwen-by-calling-api)\n- **Anthropic Claude**: [API Reference](https://docs.anthropic.com/)\n- **Grok AI**: [X.AI Documentation](https://docs.x.ai/docs)\n\n### \ud83d\udd10 Get Your API Keys\n| Platform | Get API Key | Official Website |\n|----------|-------------|------------------|\n| **Ryzenth** | [Get Key](https://ryzenths.dpdns.org) | Official Ryzenth Portal |\n| **OpenAI** | [Get Key](https://platform.openai.com/api-keys) | OpenAI Platform |\n| **Cohere** | [Get Key](https://dashboard.cohere.com/api-keys) | Cohere Dashboard |\n| **Alibaba** | [Get Key](https://bailian.console.alibabacloud.com/?tab=playground#/api-key) | Alibaba Console |\n| **Claude** | [Get Key](https://console.anthropic.com/settings/keys) | Anthropic Console |\n| **Grok** | [Get Key](https://console.x.ai/team/default/api-keys) | X.AI Console |\n\n---\n\n## \ud83c\udfc6 Credits & Contributors\n\n### \ud83c\udf10 API Provider Partners\n- **[PaxSenix](https://api.paxsenix.biz.id)** - PaxSenix Development Team\n- **[Itzpire](https://itzpire.com)** - Itzpire Development Team\n- **[Ytdlpyton](https://ytdlpyton.nvlgroup.my.id/)** - Unesa Development Team\n- **[Exonity](https://exonity.tech)** - Exonity Development Team\n- **[Yogik](https://api.yogik.id)** - Yogik Team (Legacy)\n- **[Siputzx](https://api.siputzx.my.id)** - Siputzx Development Team\n- **[FGSI](https://fgsi.koyeb.app)** - FGSI Development Team\n- **[X-API-JS](https://x-api-js.onrender.com/docs)** - Ryzenth DLR JavaScript Team\n- **[Ryzenth V2](https://ryzenths.dpdns.org)** - Ryzenth TypeScript Team\n\n### \ud83d\ude4f Special Thanks\n- **[xtdevs](https://t.me/xtdevs)** - Lead Developer & Creator\n- **TeamKillerX** - Core Development Team\n- **AkenoX Project** - Original inspiration and foundation\n- **Google Developer Tools** - AI integration support\n- **Open Source Community** - Contributions and feedback\n\n---\n\n## \ud83d\udc96 Support Development\n\nYour support helps us continue building and maintaining this project!\n\n### \ud83d\udcb0 Donation Options\n- **Bank Transfer (DANA)**: Send to Bank Jago `100201327349`\n- **Cryptocurrency**: Contact us for wallet addresses\n- **GitHub Sponsors**: [Sponsor on GitHub](https://github.com/sponsors/TeamKillerX)\n\nEvery contribution, no matter the size, makes a difference! \ud83d\ude80\n\n---\n\n## \ud83d\udcc4 License\n\n**MIT License \u00a9 2025 Ryzenth Developers from TeamKillerX**\n\nThis project is open source and available under the [MIT License](https://github.com/TeamKillerX/Ryzenth/blob/dev/LICENSE).\n\n---\n\n<div align=\"center\">\n\n### \ud83c\udf1f Star us on GitHub if you find this project useful!\n\n[![GitHub stars](https://img.shields.io/github/stars/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth)\n[![GitHub forks](https://img.shields.io/github/forks/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth/fork)\n[![GitHub watchers](https://img.shields.io/github/watchers/TeamKillerX/Ryzenth?style=social)](https://github.com/TeamKillerX/Ryzenth)\n\n**Made with \u2764\ufe0f by the Ryzenth Team**\n\n</div>\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Ryzenth is a flexible Multi-API SDK with built-in support for API key management and database integration.",
    "version": "2.2.7",
    "project_urls": {
        "Issues": "https://github.com/TeamKillerX/Ryzenth/discussions",
        "Source": "https://github.com/TeamKillerX/Ryzenth/"
    },
    "split_keywords": [
        "multi-api",
        " ryzenth-sdk",
        " ryzenth"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d2c3be0e131998a85019bed249b6d69d6711b1b2eaa48f0effe1c415b439c175",
                "md5": "75c94fb4624578d4cafc96f2607f3c12",
                "sha256": "9c77f556e3270b4761833e4e30dc7e5dd8f4ffd8f2b0664c01ff922fc2f0f845"
            },
            "downloads": -1,
            "filename": "ryzenth-2.2.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "75c94fb4624578d4cafc96f2607f3c12",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "~=3.7",
            "size": 79987,
            "upload_time": "2025-08-15T13:37:29",
            "upload_time_iso_8601": "2025-08-15T13:37:29.734661Z",
            "url": "https://files.pythonhosted.org/packages/d2/c3/be0e131998a85019bed249b6d69d6711b1b2eaa48f0effe1c415b439c175/ryzenth-2.2.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "653a84924e5b2debce1f0e0220042ac62fd81ea7cef13e40b089938f1818390a",
                "md5": "a84b50727595f98364b98d2cd05d1768",
                "sha256": "9c00b8f22986a9fe6d8d0a081201de31329f23c87198ca4cdc9443e8cf86a48a"
            },
            "downloads": -1,
            "filename": "ryzenth-2.2.7.tar.gz",
            "has_sig": false,
            "md5_digest": "a84b50727595f98364b98d2cd05d1768",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.7",
            "size": 39695,
            "upload_time": "2025-08-15T13:37:31",
            "upload_time_iso_8601": "2025-08-15T13:37:31.051839Z",
            "url": "https://files.pythonhosted.org/packages/65/3a/84924e5b2debce1f0e0220042ac62fd81ea7cef13e40b089938f1818390a/ryzenth-2.2.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-15 13:37:31",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "TeamKillerX",
    "github_project": "Ryzenth",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "ryzenth"
}