Главная Обзор Помощь
Вход
Evan
/
DoTouchAI
1
0
Ответвить 0
Файлы Задачи 0 Запросы на слияние 0 Вики
Дерево: 16fd254510
Ветки Метки
DoTouchAI
/
docs
/
design
/
web-v1.1.0
/
docs.html

docs.html 16 KB
История Исходник

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="vi">
    3. 

  3. <head>
    4. 

  4. <meta charset="UTF-8">
    5. 

  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    6. 

  6. <title>Documentation — DoTouch.AI</title>
    7. 

  7. <link rel="stylesheet" href="style.css">
    8. 

  8. </head>
    9. 

  9. <body>
    10. 

  10. 

  11. <div class="dev-note">v1.1.0 · 文档页（快速开始 / API 参考 / 错误码 / 计费）</div>
    12. 

  12. 

  13. <header>
    14. 

  14.   <div class="wrap nav">
    15. 

  15.     <a class="nav-logo" href="index.html">
    16. 

  16.       <svg viewBox="0 0 460 120" xmlns="http://www.w3.org/2000/svg">
    17. 

  17.         <defs><linearGradient id="g1" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#9B7BFF"/><stop offset="1" stop-color="#5C3DF0"/></linearGradient></defs>
    18. 

  18.         <g transform="translate(0,6) scale(0.92)"><circle cx="50" cy="50" r="33" stroke="rgba(124,92,255,.3)" stroke-width="1.5" stroke-dasharray="2 7" fill="none"/><g stroke="#00E5A0" stroke-width="1.8" opacity=".55"><line x1="50" y1="50" x2="76" y2="26"/><line x1="50" y1="50" x2="26" y2="76"/><line x1="50" y1="50" x2="78" y2="75"/></g><circle cx="50" cy="50" r="12" stroke="rgba(124,92,255,.4)" fill="none"/><circle cx="50" cy="50" r="7.5" fill="url(#g1)"/><circle cx="76" cy="26" r="4" fill="#00E5A0"/><circle cx="26" cy="76" r="4" fill="#00E5A0"/><circle cx="78" cy="75" r="4" fill="#00E5A0"/></g>
    19. 

  19.         <text x="128" y="78" font-size="50" font-weight="700" fill="#E8ECF8" font-family="inherit">DoTouch</text><text x="348" y="78" font-size="50" font-weight="700" fill="url(#g1)" font-family="inherit">.AI</text>
    20. 

  20.       </svg>
    21. 

  21.     </a>
    22. 

  22.         <nav class="nav-links">
    23. 

  23.       <a href="index.html" data-i18n="nav_home">Trang chủ</a>
    24. 

  24.       <a href="models.html" data-i18n="nav_models">Models</a>
    25. 

  25.       <a href="pricing.html" data-i18n="nav_pricing">Pricing</a>
    26. 

  26.       <a href="docs.html" class="active" data-i18n="nav_docs_ops">Hướng dẫn</a>
    27. 

  27.       <a href="../console-v1.0.0/user-console.html" data-i18n="nav_console">Console</a>
    28. 

  28.     </nav>
    29. 

  29.     <div class="nav-right">
    30. 

  30.       <div class="lang-switch">
    31. 

  31.         <button class="lang-btn active" data-lang="vi">VI</button><button class="lang-btn" data-lang="en">EN</button><button class="lang-btn" data-lang="zh-CN">简</button><button class="lang-btn" data-lang="zh-TW">繁</button>
    32. 

  32.       </div>
    33. 

  33.       <a class="btn btn-sm" href="#" data-open-auth="login" data-i18n="nav_login">Đăng nhập</a>
    34. 

  34.       <a class="btn btn-primary btn-sm" href="#" data-open-auth="register" data-i18n="nav_signup">Bắt đầu</a>
    35. 

  35.     </div>
    36. 

  36.   </div>
    37. 

  37. </header>
    38. 

  38. 

  39. <div class="wrap">
    40. 

  40.   <div class="crumbs"><a href="index.html" data-i18n="crumb_home">Trang chủ</a><span class="sep">/</span><span data-i18n="nav_docs">Tài liệu</span></div>
    41. 

  41. 

  42.   <div class="page-hero">
    43. 

  43.     <h1 data-i18n="docs_h1">Tài liệu</h1>
    44. 

  44.     <p data-i18n="docs_sub">Bắt đầu nhanh, API Reference và quy tắc tính phí.</p>
    45. 

  45.   </div>
    46. 

  46. 

  47.   <div style="display:grid;grid-template-columns:220px 1fr;gap:34px;" class="docs-layout">
    48. 

  48.     <!-- 侧边栏 -->
    49. 

  49.     <aside style="position:sticky;top:100px;align-self:start;">
    50. 

  50.       <div class="card" style="padding:16px;font-size:13.5px;">
    51. 

  51.         <a href="#start" style="display:block;padding:8px 10px;color:var(--purple-l);font-weight:600;" data-i18n="docs_sidebar_start">Bắt đầu nhanh</a>
    52. 

  52.         <a href="#api" style="display:block;padding:8px 10px;color:var(--muted);" data-i18n="docs_sidebar_api">API Reference</a>
    53. 

  53.         <a href="#errors" style="display:block;padding:8px 10px;color:var(--muted);" data-i18n="docs_sidebar_errors">Mã lỗi</a>
    54. 

  54.         <a href="#billing" style="display:block;padding:8px 10px;color:var(--muted);" data-i18n="docs_sidebar_billing">Tính phí</a>
    55. 

  55.       </div>
    56. 

  56.     </aside>
    57. 

  57. 

  58.     <!-- 内容 -->
    59. 

  59.     <main>
    60. 

  60.       <!-- 快速开始 -->
    61. 

  61.       <section id="start" style="padding-top:0;">
    62. 

  62.         <h2 style="font-size:20px;font-weight:800;margin-bottom:8px;" data-i18n="docs_start_h">Bắt đầu nhanh</h2>
    63. 

  63.         <p style="color:var(--muted);font-size:14px;margin-bottom:18px;" data-i18n="docs_start_p">3 bước để gọi mô hình đầu tiên.</p>
    64. 

  64.         <div class="grid3">
    65. 

  65.           <div class="card"><b style="color:var(--purple-l);">01</b><h3 style="margin-top:6px;font-size:14.5px;" data-i18n="s1_t">Tạo tài khoản</h3><p style="font-size:12.5px;color:var(--muted);margin-top:6px;" data-i18n="docs_start_s1">Tạo tài khoản & nạp tiền</p></div>
    66. 

  66.           <div class="card"><b style="color:var(--purple-l);">02</b><h3 style="margin-top:6px;font-size:14.5px;" data-i18n="s2_t">Tạo API key</h3><p style="font-size:12.5px;color:var(--muted);margin-top:6px;" data-i18n="docs_start_s2">Tạo API key (tiền tố dt_)</p></div>
    67. 

  67.           <div class="card"><b style="color:var(--purple-l);">03</b><h3 style="margin-top:6px;font-size:14.5px;" data-i18n="s3_t">Gọi API</h3><p style="font-size:12.5px;color:var(--muted);margin-top:6px;" data-i18n="docs_start_s3">Gọi API tương thích OpenAI</p></div>
    68. 

  68.         </div>
    69. 

  69.         <div class="code-block" style="margin-top:18px;">
    70. 

  70.           <div class="code-head"><span class="dots"><i></i><i></i><i></i></span><span>cURL · POST /v1/chat/completions</span></div>
    71. 

  71.           <pre><code><span class="c-c"># OpenAI-compatible — đổi base URL và key là xong</span>
    72. 

  72. <span class="c-k">curl</span> https://api.dotouch.ai/v1/chat/completions \
    73. 

  73.   -H <span class="c-s">"Authorization: Bearer dt_your_key_here"</span> \
    74. 

  74.   -H <span class="c-s">"Content-Type: application/json"</span> \
    75. 

  75.   -d <span class="c-s">'{
    76. 

  76.     "model": "glm-5.2",
    77. 

  77.     "messages": [{"role": "user", "content": "Xin chào!"}],
    78. 

  78.     "stream": true
    79. 

  79.   }'</span></code></pre>
    80. 

  80.         </div>
    81. 

  81.       </section>
    82. 

  82. 

  83.       <!-- API 参考 -->
    84. 

  84.       <section id="api">
    85. 

  85.         <h2 style="font-size:20px;font-weight:800;margin-bottom:8px;" data-i18n="docs_sidebar_api">API Reference</h2>
    86. 

  86.         <div class="table-wrap" style="margin-top:14px;">
    87. 

  87.           <table class="data">
    88. 

  88.             <thead><tr><th data-i18n="docs_api_endpoint">Endpoint</th><th>Method</th><th data-i18n="docs_sidebar_api">Mô tả</th></tr></thead>
    89. 

  89.             <tbody>
    90. 

  90.               <tr><td class="price">/v1/models</td><td><span class="tag tag-green">GET</span></td><td style="color:var(--muted);" data-i18n="docs_api_models_p">GET /v1/models — không cần xác thực.</td></tr>
    91. 

  91.               <tr><td class="price">/v1/chat/completions</td><td><span class="tag tag-purple">POST</span></td><td style="color:var(--muted);" data-i18n="docs_api_chat_p">POST /v1/chat/completions — xác thực bằng Bearer API key. Hỗ trợ streaming SSE.</td></tr>
    92. 

  92.               <tr><td class="price">/v1/auth/*</td><td><span class="tag tag-purple">POST</span></td><td style="color:var(--muted);">Register / Login / Me</td></tr>
    93. 

  93.               <tr><td class="price">/v1/keys</td><td><span class="tag tag-purple">POST</span></td><td style="color:var(--muted);">Tạo API key (Console)</td></tr>
    94. 

  94.               <tr><td class="price">/v1/usage/summary</td><td><span class="tag tag-green">GET</span></td><td style="color:var(--muted);">Tổng kết sử dụng theo ngày</td></tr>
    95. 

  95.             </tbody>
    96. 

  96.           </table>
    97. 

  97.         </div>
    98. 

  98.       </section>
    99. 

  99. 

  100.       <!-- 错误码 -->
    101. 

  101.       <section id="errors">
    102. 

  102.         <h2 style="font-size:20px;font-weight:800;margin-bottom:8px;" data-i18n="docs_sidebar_errors">Mã lỗi</h2>
    103. 

  103.         <p style="color:var(--muted);font-size:13.5px;margin-bottom:14px;">Định dạng lỗi tương thích OpenAI: <code class="price" style="color:var(--purple-l);">{error: {message, type, code, param}}</code></p>
    104. 

  104.         <div class="table-wrap">
    105. 

  105.           <table class="data">
    106. 

  106.             <thead><tr><th>HTTP</th><th data-i18n="docs_sidebar_errors">Mã lỗi</th><th>type</th></tr></thead>
    107. 

  107.             <tbody>
    108. 

  108.               <tr><td class="price">401</td><td data-i18n="docs_err_401">API key không hợp lệ</td><td class="price">invalid_api_key</td></tr>
    109. 

  109.               <tr><td class="price">402</td><td data-i18n="docs_err_402">Số dư không đủ</td><td class="price">insufficient_balance</td></tr>
    110. 

  110.               <tr><td class="price">404</td><td data-i18n="docs_err_404">Mô hình không tồn tại</td><td class="price">model_not_found</td></tr>
    111. 

  111.               <tr><td class="price">429</td><td data-i18n="docs_err_429">Vượt giới hạn tốc độ</td><td class="price">rate_limit_exceeded</td></tr>
    112. 

  112.               <tr><td class="price">500</td><td>Lỗi máy chủ / thượng nguồn</td><td class="price">api_error</td></tr>
    113. 

  113.             </tbody>
    114. 

  114.           </table>
    115. 

  115.         </div>
    116. 

  116.       </section>
    117. 

  117. 

  118.       <!-- 计费 -->
    119. 

  119.       <section id="billing">
    120. 

  120.         <h2 style="font-size:20px;font-weight:800;margin-bottom:8px;" data-i18n="docs_sidebar_billing">Tính phí</h2>
    121. 

  121.         <div class="card" style="max-width:700px;">
    122. 

  122.           <p style="font-size:14px;color:var(--muted);" data-i18n="docs_bill_p">Phí = token × đơn giá (USD), quy đổi VND theo tỷ giá tại thời điểm nạp tiền. Lịch sử giao dịch trong Console.</p>
    123. 

  123.           <div style="margin-top:14px;display:flex;gap:10px;flex-wrap:wrap;">
    124. 

  124.             <span class="tag tag-purple">MoMo</span><span class="tag tag-purple">ZaloPay</span><span class="tag tag-purple">Stripe</span><span class="tag tag-purple">PayPal</span><span class="tag tag-purple">Alipay</span><span class="tag tag-purple" data-i18n="pay_card">Thẻ ngân hàng</span>
    125. 

  125.           </div>
    126. 

  126.         </div>
    127. 

  127.       </section>
    128. 

  128.     </main>
    129. 

  129.   </div>
    130. 

  130. </div>
    131. 

  131. 

  132. <footer>
    133. 

  133.   <div class="wrap">
    134. 

  134.     <div class="foot-grid">
    135. 

  135.       <div class="foot-brand">
    136. 

  136.         <svg viewBox="0 0 460 120" width="140" xmlns="http://www.w3.org/2000/svg">
    137. 

  137.           <defs><linearGradient id="fg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#9B7BFF"/><stop offset="1" stop-color="#5C3DF0"/></linearGradient></defs>
    138. 

  138.           <g transform="translate(0,6) scale(0.92)"><circle cx="50" cy="50" r="33" stroke="rgba(124,92,255,.3)" stroke-width="1.5" stroke-dasharray="2 7" fill="none"/><g stroke="#00E5A0" stroke-width="1.8" opacity=".55"><line x1="50" y1="50" x2="76" y2="26"/><line x1="50" y1="50" x2="26" y2="76"/><line x1="50" y1="50" x2="78" y2="75"/></g><circle cx="50" cy="50" r="7.5" fill="url(#fg)"/><circle cx="76" cy="26" r="4" fill="#00E5A0"/><circle cx="26" cy="76" r="4" fill="#00E5A0"/><circle cx="78" cy="75" r="4" fill="#00E5A0"/></g>
    139. 

  139.           <text x="128" y="78" font-size="50" font-weight="700" fill="#E8ECF8" font-family="inherit">DoTouch</text><text x="348" y="78" font-size="50" font-weight="700" fill="url(#fg)" font-family="inherit">.AI</text>
    140. 

  140.         </svg>
    141. 

  141.         <p data-i18n="foot_p">AI Trung Quốc giá rẻ cho lập trình viên và doanh nghiệp nhỏ trên toàn thế giới.</p>
    142. 

  142.       </div>
    143. 

  143.       <div class="foot-col"><h4 data-i18n="foot_product">Sản phẩm</h4><a href="models.html" data-i18n="nav_models">Mô hình</a><a href="pricing.html" data-i18n="nav_pricing">Bảng giá</a><a href="#" data-i18n="foot_console">Console</a><a href="#" data-i18n="foot_status">Trạng thái</a></div>
    144. 

  144.       <div class="foot-col"><h4 data-i18n="foot_dev">Nhà phát triển</h4><a href="docs.html" data-i18n="foot_docs">Tài liệu</a><a href="docs.html" data-i18n="foot_quickstart">Bắt đầu nhanh</a><a href="#" data-i18n="foot_support">Hỗ trợ</a></div>
    145. 

  145.       <div class="foot-col"><h4 data-i18n="foot_legal">Pháp lý</h4><a href="#" data-i18n="foot_tos">Điều khoản dịch vụ</a><a href="#" data-i18n="foot_privacy">Chính sách bảo mật</a><a href="#" data-i18n="foot_refund">Chính sách hoàn tiền</a></div>
    146. 

  146.     </div>
    147. 

  147.     <div class="foot-bottom"><span>© 2026 DoTouch.AI — doTouch.ai</span><span data-i18n="foot_made">Thế giới mã nguồn mở · 算力普惠</span></div>
    148. 

  148.   </div>
    149. 

  149. </footer>
    150. 

  150. 

  151. <div class="support-panel" id="supportPanel">
    152. 

  152.   <div class="support-head"><b data-i18n="chat_title">Trợ giúp & Hỗ trợ</b><span class="chat-status" data-i18n="chat_online">Trực tuyến</span></div>
    153. 

  153.   <div class="support-body">
    154. 

  154.     <p data-i18n="chat_hello">Xin chào! Chúng tôi có thể giúp gì cho bạn?</p>
    155. 

  155.     <div class="chat-sugg">
    156. 

  156.       <button data-i18n="chat_q_balance">Làm sao để nạp tiền?</button>
    157. 

  157.       <button data-i18n="chat_q_key">Tạo API key thế nào?</button>
    158. 

  158.       <button data-i18n="chat_q_model">Nên chọn mô hình nào?</button>
    159. 

  159.     </div>
    160. 

  160.     <div class="chat-input"><input placeholder="Nhập tin nhắn..." data-i18n="chat_input"><button>➤</button></div>
    161. 

  161.     <div class="chat-channels"><a class="tag tag-purple" href="#">Zalo</a><a class="tag tag-green" href="#">Telegram</a><a class="tag tag-gray" href="#">Email</a></div>
    162. 

  162.   </div>
    163. 

  163. </div>
    164. 

  164. <button class="support-fab" id="supportFab" aria-label="Support">
    165. 

  165.   <span class="pulse-ring"></span>
    166. 

  166.   <svg viewBox="0 0 24 24" width="26" height="26" fill="#fff"><path d="M12 3C7 3 3 6.6 3 11c0 2.3 1 4.3 2.7 5.8L5 20l3.4-1.5c1.1.4 2.3.5 3.6.5 5 0 9-3.6 9-8s-4-8-9-8z"/><circle cx="8.5" cy="11" r="1.2" fill="#0B1020"/><circle cx="12" cy="11" r="1.2" fill="#0B1020"/><circle cx="15.5" cy="11" r="1.2" fill="#0B1020"/></svg>
    167. 

  167. </button>
    168. 

  168. 

  169. <div class="modal-mask" id="authModal">
    170. 

  170.   <div class="modal">
    171. 

  171.     <button class="modal-close" aria-label="Close">✕</button>
    172. 

  172. 

  173.     <div id="viewLogin">
    174. 

  174.       <h3 data-i18n="auth_login_title">Đăng nhập</h3>
    175. 

  175.       <div class="auth-error" data-i18n="auth_err_email">Email không hợp lệ</div>
    176. 

  176.       <div class="field"><label data-i18n="auth_email">Email</label><input type="email" placeholder="you@example.com"></div>
    177. 

  177.       <div class="field"><label data-i18n="auth_password">Mật khẩu</label><input type="password"></div>
    178. 

  178.       <button class="btn btn-primary btn-block" data-i18n="auth_login_btn">Đăng nhập</button>
    179. 

  179.       <div class="auth-links"><a data-auth-view="reset" data-i18n="auth_forgot">Quên mật khẩu?</a><a data-auth-view="register" data-i18n="auth_to_register">Tạo tài khoản</a></div>
    180. 

  180.     </div>
    181. 

  181. 

  182.     <div id="viewRegister" hidden>
    183. 

  183.       <h3 data-i18n="auth_register_title">Tạo tài khoản</h3>
    184. 

  184.       <div class="auth-error" data-i18n="auth_err_pwd">Mật khẩu không khớp</div>
    185. 

  185.       <div class="field"><label data-i18n="auth_email">Email</label><input type="email" placeholder="you@example.com"></div>
    186. 

  186.       <div class="field"><label data-i18n="auth_password">Mật khẩu</label><input type="password"></div>
    187. 

  187.       <div class="field"><label data-i18n="auth_confirm">Xác nhận mật khẩu</label><input type="password"></div>
    188. 

  188.       <div class="field">
    189. 

  189.         <label data-i18n="auth_code_label">Mã xác minh</label>
    190. 

  190.         <div class="code-row">
    191. 

  191.           <input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1">
    192. 

  192.           <button class="btn btn-sm code-send" data-send-code data-i18n="auth_code_send">Gửi mã</button>
    193. 

  193.         </div>
    194. 

  194.         <p class="auth-note" data-code-note data-i18n="auth_code_note">Mã gồm 8 ký tự chữ hoa & số, hiệu lực 15 phút</p>
    195. 

  195.       </div>
    196. 

  196.       <button class="btn btn-primary btn-block" data-i18n="auth_register_btn">Đăng ký</button>
    197. 

  197.       <div class="auth-links"><a data-auth-view="login" data-i18n="auth_to_login">Đã có tài khoản? Đăng nhập</a></div>
    198. 

  198.     </div>
    199. 

  199. 

  200.     <div id="viewReset" hidden>
    201. 

  201.       <h3 data-i18n="auth_reset_title">Đặt lại mật khẩu</h3>
    202. 

  202.       <div class="auth-error" data-i18n="auth_err_pwd">Mật khẩu không khớp</div>
    203. 

  203.       <div class="field"><label data-i18n="auth_email">Email</label><input type="email" placeholder="you@example.com"></div>
    204. 

  204.       <div class="field">
    205. 

  205.         <label data-i18n="auth_code_label">Mã xác minh</label>
    206. 

  206.         <div class="code-row">
    207. 

  207.           <input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1"><input class="code-cell" maxlength="1">
    208. 

  208.           <button class="btn btn-sm code-send" data-send-code data-i18n="auth_code_send">Gửi mã</button>
    209. 

  209.         </div>
    210. 

  210.         <p class="auth-note" data-code-note data-i18n="auth_code_note">Mã gồm 8 ký tự chữ hoa & số, hiệu lực 15 phút</p>
    211. 

  211.       </div>
    212. 

  212.       <div class="field"><label data-i18n="auth_new_pwd">Mật khẩu mới</label><input type="password"></div>
    213. 

  213.       <div class="field"><label data-i18n="auth_confirm_new">Xác nhận mật khẩu mới</label><input type="password"></div>
    214. 

  214.       <button class="btn btn-primary btn-block" data-i18n="auth_reset_btn">Đặt lại mật khẩu</button>
    215. 

  215.       <div class="auth-links"><a data-auth-view="login" data-i18n="auth_back_login">Quay lại đăng nhập</a></div>
    216. 

  216.     </div>
    217. 

  217.   </div>
    218. 

  218. </div>
    219. 

  219. 

  220. <script src="i18n.js"></script>
    221. 

  221. </body>
    222. 

  222. </html>
    223.