Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tavily Search

Felo API Support
MIT
เซิร์ฟเวอร์:https://openapi.felo.ai
ไลบรารีไคลเอนต์
Shell Curl

Tavily Search

​

ค้นหาเว็บและคืนผลลัพธ์ที่จัดอันดับพร้อมชื่อเรื่อง URL และตัวอย่างเนื้อหา query เป็นฟิลด์บังคับ ใช้ max_results ควบคุมจำนวนผลลัพธ์ และ search_depth เลือกโหมดการค้นหา answer, images และ raw content จะถูกคืนค่าเมื่อร้องขอเท่านั้น ตั้งค่า include_usage เพื่อรับข้อมูลการใช้ทรัพยากร usage.credits ไม่ใช่ค่าใช้จ่ายจาก Felo

ข้อมูลอ้างอิงราคา

  • การวัดปริมาณการใช้งาน: หน่วยการตอบกลับที่วัดปริมาณ
  • ค่าประมาณคำขออ้างอิง: USD 0.016
  • ต้นทุนต่อหน่วยพื้นฐาน: USD 0.008
  • หน่วยทรัพยากร: tavily_credit
  • ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
  • ต้นทุนพื้นฐานไม่ได้กำหนดราคาสุดท้ายของลูกค้า รวมถึงกรณีที่เป็นศูนย์

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้
จำเป็น
application/json
  • query
    ประเภท: string
    จำเป็น

    คำค้นที่จะดำเนินการกับ Tavily

  • auto_parameters
    ประเภท: boolean

    กำหนดค่าพารามิเตอร์การค้นหาอัตโนมัติตามเนื้อหาของ query

  • chunks_per_source
    ประเภท: integer
    ต่ำสุด:  
    1
    สูงสุด:  
    3

    จำนวนชังก์ที่เกี่ยวข้องสูงสุดที่คืนต่อแหล่งข้อมูล

  • country
    ประเภท: string enum

    เพิ่มน้ำหนักผลการค้นหาจากประเทศที่ระบุ ใช้ได้เฉพาะเมื่อ topic เป็น general

    ค่า
    • afghanistan
    • albania
    • algeria
    • andorra
    • angola
  • end_date
    ประเภท: string รูปแบบ: date

    คืนผลลัพธ์ก่อนวันที่สิ้นสุดที่ระบุ

  • exclude_domains
    ประเภท: array string[] …150

    รายการโดเมนที่ต้องการตัดออกจากผลการค้นหาโดยเฉพาะ

  • include_answer

    รวมคำตอบที่สร้างโดย LLM true ใช้โหมดคำตอบเริ่มต้น; basic หรือ advanced เลือกโหมดการสร้างคำตอบ

    • ประเภท: boolean

      รวมคำตอบที่สร้างโดย LLM true ใช้โหมดคำตอบเริ่มต้น; basic หรือ advanced เลือกโหมดการสร้างคำตอบ

  • include_domains
    ประเภท: array string[] …300

    รายการโดเมนที่ต้องการรวมไว้ในผลการค้นหาโดยเฉพาะ

  • include_favicon
    ประเภท: boolean

    รวม URL favicon สำหรับแต่ละผลลัพธ์

  • include_image_descriptions
    ประเภท: boolean

    เพิ่มข้อความอธิบายสำหรับแต่ละรูปภาพเมื่อ include_images เป็น true

  • include_images
    ประเภท: boolean

    ค้นหารูปภาพและรวมผลลัพธ์ไว้ด้วย

  • include_raw_content

    รวมเนื้อหาที่ทำความสะอาดและแยกวิเคราะห์แล้วสำหรับแต่ละผลการค้นหา true หรือ markdown คืน markdown; text คืนข้อความธรรมดาและอาจเพิ่มความหน่วง

    • ประเภท: boolean

      รวมเนื้อหาที่ทำความสะอาดและแยกวิเคราะห์แล้วสำหรับแต่ละผลการค้นหา true หรือ markdown คืน markdown; text คืนข้อความธรรมดาและอาจเพิ่มความหน่วง

  • include_usage
    ประเภท: boolean

    รวมข้อมูลการใช้ทรัพยากรไว้ในการตอบกลับ นี่ไม่ใช่ข้อมูลการเรียกเก็บเงินของ Felo

  • max_results
    ประเภท: integer
    ต่ำสุด:  
    0
    สูงสุด:  
    20

    จำนวนผลการค้นหาสูงสุดที่จะคืน

  • ประเภท: boolean

    กรองเนื้อหาผู้ใหญ่หรือไม่ปลอดภัยออกจากผลการค้นหา เฉพาะ Enterprise; ไม่รองรับเมื่อ search_depth เป็น fast หรือ ultra-fast

  • search_depth
    ประเภท: string enum

    ควบคุมการแลกเปลี่ยนระหว่างความหน่วงและความเกี่ยวข้อง advanced ให้ความเกี่ยวข้องสูงสุดพร้อมความหน่วงและต้นทุนที่สูงขึ้น; basic มีความสมดุล; fast และ ultra-fast ปรับให้ความหน่วงต่ำลง

    ค่า
    • advanced
    • basic
    • fast
    • ultra-fast
  • start_date
    ประเภท: string รูปแบบ: date

    คืนผลลัพธ์หลังวันที่เริ่มต้นที่ระบุ

  • time_range
    ประเภท: string enum

    ช่วงเวลาสำหรับกรองผลลัพธ์ตามวันที่เผยแพร่

    ค่า
    • day
    • week
    • month
    • year
    • d
    • w
    • m
    • y
  • topic
    ประเภท: string enum

    หมวดหมู่ของการค้นหา

    ค่า
    • general
    • news
    • finance
การตอบกลับ
  • 200
    ประเภท: object

    คืนผลการค้นหาสำเร็จแล้ว

    • answer
      ประเภท: string | null

      คำตอบสั้นที่สร้างโดย LLM จะเป็น null เมื่อ include_answer เป็น false หรือไม่มีการสร้างคำตอบ

    • images
      ประเภท: array object[]
      • description
        ประเภท: string

        คำอธิบายรูปภาพ

      • url
        ประเภท: string

        URL รูปภาพ

    • query
      ประเภท: string

      คำค้นที่ดำเนินการแล้ว

    • request_id
      ประเภท: string

      ตัวระบุคำขอที่ไม่ซ้ำ

    • response_time
      ประเภท: number รูปแบบ: float

      เวลาเป็นวินาทีที่ใช้ในการดำเนินการคำขอให้เสร็จ

    • results
      ประเภท: array object[]
      • content
        ประเภท: string

        ข้อความย่อของเนื้อหาผลการค้นหา

      • favicon
        ประเภท: string | null

        URL favicon ของผลการค้นหา

      • raw_content
        ประเภท: string | null

        เนื้อหาแหล่งข้อมูลที่ทำความสะอาดและแยกวิเคราะห์แล้ว เป็น null เว้นแต่จะมีการขอ include_raw_content หรือไม่มีเนื้อหาดิบให้ใช้

      • score
        ประเภท: number รูปแบบ: float

        คะแนนความเกี่ยวข้องของผลการค้นหา

      • title
        ประเภท: string

        ชื่อของผลการค้นหา

      • url
        ประเภท: string

        URL ของผลการค้นหา

    • usage
      ประเภท: object
      • credits
        ประเภท: integer

        หน่วยทรัพยากรที่คำขอนี้ใช้ไป ไม่ใช่ USD หรือเครดิต Felo

    application/json
  • 400

    ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ

  • 401

    จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

  • 402

    ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

  • 403

    บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

  • 429

    ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

  • 502

    บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

  • 503

    API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

  • 504

    บริการหมดเวลาระหว่างประมวลผลคำขอ

  • default

    การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

    application/json
Request Example for post/v1/beta/tavily/search
curl --request POST https://openapi.felo.ai/v1/beta/tavily/search \
  --header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'

{
  "query": "Python official documentation",
  "answer": null,
  "images": [],
  "results": [
    {
      "title": "Python Documentation",
      "url": "https://docs.python.org/3/",
      "content": "Documentation for the Python programming language.",
      "score": 0.98,
      "raw_content": null
    }
  ],
  "response_time": 1.2,
  "usage": {
    "credits": 1
  },
  "request_id": "example-search-request"
}

คืนผลการค้นหาสำเร็จแล้ว

Tavily Search